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Foreword 


The C language under CP/M~68K™ is easy to read, easy to 
maintain, and highly portable. CP/M-68K can run most applications 
written in C for the UNIX® operating system, except programs that 
use the UNIX fork/exec multitasking primitives or that read UNIX 
file structures. 


The ¢ Language Programming Guide for CP/M-68K is not a 
tutorial. This manual describes how to program in C under the CP/M-~ 
6ak operating System, and is best used by programmers familiar with 


the C language as described in The C Programming Language (Kernighan 
and Ritchie, 1978). 


The commonly accepted Standard for C language programming is 
the Portable C Compiler (PCC), written by Stephen C. Johnson. Many 
versions of the UNIX operating system use PCC, including the 
Zilog® , ONYX™ , Xenix® , Berkeley UNIX, and UNIQ™ systems. 


The CP/M-68K C compiler differs from PCC on the following 
points: 


@ The CP/M-68K C int (default) data type is 16 bits long. 
Pointers are 32 bits long. All function definitions and 
function calls that use long (32-bit ints) and pointer 
parameters must use the proper declarations. 


@ long, int, and char register variables are assigned to D 
registers. Five such registers are available in each 
procedure. 


e@ Any register variable used as a pointer is assigned to an A 
register. There are three such registers available in each 
procedure. 


@ All local declarations in a function body must precede the 
first executable statement of the function. 


@ The CP/M-68K C compiler handles structure initialization as if 
the structure were an array of short integers, as in UNIX 
version 6. 


e The first eight characters of variable and function names must 
be unique. The first seven characters of external names must 
be unique. 
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@ The CP/M-68K C compiler does not support floating point. 


@ The CP/M-68K C compiler does not support structure assignment, 
structure arguments, and structures returned from procedures. 


@ The CP/M-68K C compiler does not support initialization of C> 
automatic variables. 


@ The CP/M-68K C compiler does not support enumeration types. 


Section 1 of this manual describes the conventions of using C 
language under CP/M-68K. Section 2 discusses C language 
compatibility with UNIX version 7 and provides a dictionary of C 
library routines for CP/M-68K. Section 3 presents a style guide for 
coding C language programs. 


Appendix A is a table of CP/M-68K error codes. Appendix B 
discusses compiler components, tells you how to operate the 
compiler, and suggests ways to conserve the disk space used for 
compiling. Finally, Appendix C presents sample C modules that are 
written and documented according to the style conventions outlined 
in Section 3. 
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Section | 
Using C Language Under CP/M-68K 


1.1 Compiling a CP/M-68K C Program 


To compile a C program under CP/M-68K, use the c.sub and 
clink.sub command files. You can separately compile files with 
these commands. You must type the commands as shown in the command 
line. To invoke the compiler, use the following command form: 


{submit] c file 


where file.c is the filename. The submit command is optional. The 
compiler produces file.o as the object. To invoke the linker, use 
the following command form: 


[submit] clink file 


The command file automatically includes all libraries and 
header files. You can specify multiple files. For example, the 
following commands compile and link files a.c, b.c, and c.c: 


A>submit c a 
A>submit c b 
A>submit c c 
A>submit clink a bec 


The output goes to file A.68K. 


1.2 Memory Layout 


The memory layouts of C programs in CP/M-68K are similar to 
those of UNIX C programs. The program comprises three segments: 
text instructions, initialized data, and BSS, which is uninitialized 
data. Automatic variables are allocated on the stack. These 
segments are arranged in memory as illustrated in Figure 1-1.’ 
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Figure 1~1. Memory Layout 


There are two dynamic memory areas: the stack and the heap. 
Procedure calls and automatic variables use the stack. The obrk, 
sbrk, malloc, and free procedures manage the heap. Dynamically 
growing data structures, such as symbol tables, use the heap. 


The linkage editor defines the locations etext, edata, and end. 
The locations determine the ending addresses of the text, data, and 
BSS segments. The break location is the first free location 
following the heap area. 


1.3 Calling Conventions 


The jump to subroutine (JSR) instruction calls procedures inC. 
Register A6 acts as the frame pointer for referencing local storage. 
Arguments are pushed in reverse order onto the A7 stack. Word and 
character arguments to functions occupy 16 bits on the stack. Long 
and pointer arguments occupy 32 bits. The function value return 
register is always DO. Functions that declare no return value 
return an undefined value. 


For example, the following sequence 


xyz() { 
long a; 
int b; 
char x} 


register y; 


b = blivot (x,a); 
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1.3 Calling Conventions 


generates the following code: 
_xyZ: 
link a6 ,#-8 * Space for a,b,x 
movem.1 d6—-d7,-(a7) * a7 used for y 


» 


d6 reserves space 


move.l -4(a6), (a7) * Load parameter a 
move.b -8(a6),d0 * Load parameter x 
ext.w dao * Extend to word size 
move.w d0,-(a7) * Push it 

jsr _blivot * Call subroutine 

add.l #2,a7 * Pop argument list 
move.w d0,-6(a6) * Store return parameter 
tst.1 (a7)+ * Purge longword 
movem.1 (a7)+,d7 * Unsave registers 

unlk a6 * Restore frame pointer 
rts * Return to caller 


C code, in which all arguments are the same length, might not 


work without modification because of the varying length of arguments 
on the stack. 


ane 


The compiler adds an underline character, _, to the beginning 
of each external variable or function name. 
external names in C must be unique in seven characters. 


This means that all 


The compiler-generated code maintains a long word at the top of 
the stack for use in subroutine calls. This shortens the stack-— 
popping code required on return from a procedure call. The movem.1 
instruction, which saves the registers, contains an extra register 
to allocate this space. 


for register variables. 


save and restore these registers, if they are used. 
generated code saves only those registers used. 


through D2, and. AO through A2, 


The compiler uses registers D3 through D7, and A3 through AS, 


A procedure called from a C program must 


modified by the called procedure. 


) 


( 


The compiler- 
Registers DO 


are scratch registers and can be 
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1.4 Stack Frame 


Figure 1-2 illustrates the standard C stack frame. 


A? 


Figure 1-2. C Stack Frame 


A6é-—— 


Arguments are either 2 or 4 bytes, depending on argument type. 


The compiler~generated code uses A6 to reference all variables on 
the stack. 


1.5 Command Line Interface 


The standard C arge/argv interface for arguments typed on the 


command line also works under CP/M-68K. For example, the command 
form 


command argl arg2 arg3 Te argn : 


causes the following interface setup: 


arge = n+l 
argv[0] => "Cc Runtime" 
argv(l} -> “argl" 
argv[2] -> "arg2" C) 
argv[n] -> argn 
Bll information Presenteé Here if Proprietary to Digité: Researcn 
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1.5 Command Line Interface 


You cannot obtain the command name under CP/M-68K. Therefore, the 
argv{0] argument is always incorrect. 


1.6 I/O Conventions © 


UNIX C programs use two types of file and device I/O: regular 
files and stream files. A unique number, called a file descriptor, 
identifies regular files. In CP/M-68K, this number is in the range 
0 to 15. The address of a user control block in the run-time system 
identifies stream files. Unlike regular files, stream files use 


some form of intermediate buffering, making single-byte I/O more 
efficient. 


Under UNIX, you can reference peripheral devices, such as 
terminals and printers, as files, using the special names /dev/tty 
for terminal and /dev/lp for printer. Under CP/M-68K, CON: is for 
the console device, and LST: is for the listing device. : 


CP/M-68K stores ASCII files with a carriage return line-feed 
after each line. A CTRL-2 (Oxla) character indicates end-of-file. 
C programs usually end lines with only a line-feed.: This means that 
in CP/M-68K C, read and write operations to ASCII files must insert 
and delete carriage-return characters. The CTRL-Z must be deleted 
on read and inserted on close for such files. These operations are 
not desirable for binary files. CP/M-68K C includes an extra entry 
point to all file open and creat calls to distinguish between ASCII 
and binary files. 


1.7 Standard Files 


C programs begin execution with three files already open: the 
standard input, standard output, and standard error files. You can 
access these files as either stream or regular files in the C 
program. The following definitions are available from the <stdio.h> 
file: 


fable 1-1. Standard File Definitions 


standard input . stdin 
standard output stdout 
standard error stderr 


The usual library routines close and reopen these standard 
files. In addition, you can redirect I/O from the command line. 


eee <0 geo 


C Programming Guide 1.8 1/0 Redirection 


1.8 I/0 Redirection 
You can redirect the C program standard 1/0 with the < and > 
characters. No space is allowed between the < or > and the 
filename. You cannot redirect the standard error file. 
For example, the command 
test <a >lst: cdeef 
executes the file test.68K, with the standard input coming from disk 


file a and the standard output going to the listing device. The 
argument list is cde f. 


End of Section 1 
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Section 2 
C Language Library Routines 


—~ The CP/M-68K C library is a collection of routines for I/O, 
dynamic memory allocation, system traps, and data conversion. 


2.1 Compatibility with UNIX v7 


The C library is compatible with UNIX version 7, allowing 
programs to move easily from UNIX to CP/M-68K. CP/M-68K C simulates 
many UNIX operating system calls and features. However, CP/M-68K 
does not support the following C functions that UNIX implements: 


@ the fork/exec, kill, lock, nice, pause, ptrace, sync, and wait 
primitives 

the acct system call 

the alarm function, or the stime, time, ftime, and times system 
calls 
@ the dup and dup2 duplicate file descriptor functions 
@e the getuid, getgid, geteuid, getegid, setuid, and setgid 

functions 


e@ the indir indirect system call 
@e the ioctl, stty, and gtty system calls 
@ the link system call 
ox @e the chdir, chroot, mknod, mount, umount, mpx, pipe, pkon, 
: pkoff£, profil, sync, stat, fstat, umask, and utime system calls 
iad @ the phys system call 
The following UNIX library functions are not available under 
CP /M-68K: 
@ Assert 
@ Crypt 
@ DBM 
e Getenv 
. e Getgrent, getlogin, getpw, and getpwent functions 
e 1l3tol, ltol3 
@ monitor 
e@ itom, madd, msub, mult, mdiv, min, mout, pow, gcd, and rpow 
e@ nlist ’ 
@ pkopen, pkclose, pkread, pkwrite, and pkfail 
@ plot 
@®. popen, pclose 
@ sleep 
@ system 
“~~ e ttyslot 


“ ra 
Sew’ 


The CP/M-68K C language library does not contain the floating- 
point routines available under UNIX. 
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Entry points have been added to file open and creat calls to 
distinguish between ASCII and binary files. Byte level end-of-file 
is unavailable for binary files. ASCII files, however, are 
compatible with UNIX, and with the CP/M-68K text editors and 
utilities that use ASCII files. : 


The C Programming Guide for CP/M-68K does not separate the 
UNIX system calis and library functions; all calls are library 


functions under CP/M-68K. 


2.2 Library Functions under CP/M-68K 


The remainder of this section lists alphabetically the library 
routines that C supports under CP/M-68K. The C compiler accepts 
entry in both upper- and lower-case; however, you must type all 
library routines in lower-case, as shown in the calling sequences. 
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The abort Function 


The abort function terminates the current program with an 
error. The error is system dependent. The 68000 uses an illegal 


instruction trap. This invokes DDT-68K™, if the debugger is loaded 
with the object program. 


Calling Sequence: 
WORD code; 


abor t (code) ; 


Arguments: 


code loads into register DO before abort 


Returns: 


The abort function never returns. 
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The abs Function 


ee enna 


The abs function takes the absolute value of a single argument. 
This function is implemented as a macro in <stdio.h>; arguments with 
side effects do not work as you expect. For example, the call 
a = abs (*x++); 


increments x twice. 


Calling Sequence: 


WORD val; 
WORD ret; 


ret = abs(val); 


Ar guments: 


val the input value 


Returns: 


ret the absolute value of val C 


as 


~ fre : a bap] uo m = é 7 . ‘o% = ‘ 
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C Programming Guide access Function 


The access Function 


The access function checks whether the invoking program can 
legally access a file. Under CP/M~-68K, the file is accessible if it 
exists. 


Calling Sequence: 


BYTE *name; 
WORD mode; 
WORD ret; 


ret * access(name, mode); 


Arguments: 
name points to the null-terminated filename 


mode 4 to check read access 
2 to check write access 
1 to check exec access 
0 to check directory path access (CP/M-68K ignores 
this argument) 


Returns: 

0 access allowed 

-1 access not allowed 
Note: 


CP/M-68K checks only to see if the file exists. 
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The atoi, atol Punctions 


en eel 


The atoi and atol functions convert an ASCII string to an 
integer or long binary number, respectively. Strings converted by 
atoi and atol have the following format: 
| [ .--JI-] [+]dddddd .... 


The functions ignore leading spaces and permit one leading sign. 


Calling Sequence: 


BYTE *string; 
WORD ival; 
LONG lval,atol(); ‘ 


ival = atoi(string); 
lval = atol(string); 
Arguments: 

- atol is not a default value and must be declared. String 
is a null-terminated string containing the number to be 
converted. Conversion proceeds until the digits are 
exhausted. Zero returns if no digits remain. 


Returns: 


Converted value as ival (int), or lval (long). 


Note: 
The atoi and atol functions do not detect or report 
overflow. You cannot limit the number of contiguous digits 
processed or determine the number of digits actually 
precessed. 
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The brk, sbrk Functions 


The brk and sbrk functions extend the heap portion of the user 
~~ program. The brk function sets the upper bound of the program, 
a called the break in UNIX terminology, to an absolute address. The 

ee sbrk function extends the program by an incremental amount. 


Calling Sequence: 


WORD brk(); 

BYTE *addr,*sbrk(); 
WORD ret; 

BYTE *start; 


ret = brk (addr); 
start = sbrk(incr) 


Arguments: 


addr the desired new break address 

incr the incremental number of bytes desired 
fo™ 
fo Returns: , 
ee ot 

0 success (brk) 

~1 failure (brk) 

start begins the allocated area (sbrk) 

0 failure (sbrk) 
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C Programming Guide callec, malloc, realloc, free Functions 


The calloc, malloc, realloc, free Functions 


The calloc, malloc, realloc, and free functions manage the 
dynamic area between the region and the stack. 


The malloc function allocates an area of contiguous bytes 
aligned on a word boundary and returns the address of this area. 
Malloc uses the sbrk function to allocate additional heap space, if 
necessary. 


The calloc function allocates space for an array of elements, 
whose size is given in bytes. 


The realloc function changes the size of a block. The address 
of the block returns. 


The free function releases a block previously allocated by 
malloc. 


Calling Sequence: 


WORD size,number; 
BYTE *addr,*malloc(),*calloc(),*realloc(); 


addr = malloc(size); 

addr = calloc(number, size); 
addr = realloc(addr,size); 
free (addr); 


Arguments: 
size the number of bytes desired 
“number the number of elements desired 
vaddr points to the allocated region 
Returns: 


Address of the allocated region if successful, 0 if 
unsuccessful. 


Note: 


Freeing a bogus address can be disastrous. 
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The chmod, chown Functions 


Under UNIX, the chmod and chown system calls allow you to 
change the protection and owner ID of an existing file. CP/M-68K 
treats these calls as NO-OPS if the file exists. 


Calling Sequence: 
‘BYTE *name; 
WORD mode,owner,group,ret; 
ret = chmod (name ,mode); 


ret = chown (name,owner ,group); 


Arguments: 


name the affected filename (null-terminated) 
mode the new mode for the file 

owner the new owner of the file 

group the new group number 


Returns: 


ret 0 if the file exists 
-1 if the file does not exist 
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C Programming Guide close Function 


The close Function 
a 


The close function terminates access to a file or device. This 
routine acts on files opened with the open or creat functions. fo 
Specify a file descriptor, not a stream, for the operation. The i. - 
fclose function closes stream files. 


Calling Sequence: 


WORD fd,ret;: 


ret = close(fd); 


Arguments: 


fd the file descriptor to be closed 
Returns: 
0 successful close 
-1 unknown file descriptor 
©) 
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The creat, creata, creatb Functions 


_ he creat function adds a new file to a disk directory. The 
file can then be referenced by the file descriptor, but not as a 
Stream file. The creat and creata functions create an ASCII file. 
The creatb function creates a binary file. 


Calling Sequence: 
BYTE *name; 
WORD mode, fd; 
fd creat (name ,mode) ; 


fd = creata(name,mode); 
fd = creatb (name ,mode); 


Ar gumen ts: 


name the filename string, null-terminated 
mode the UNIX file mode, ignored by CP/M-68K 


Returns: 
fd The file descriptor for the opened file. A file 
descriptor is an int quantity that denotes an open 
file in a read, write, or lseek call. 
-1 Returned if there are any errors, 
Note: 


UNIX programs that use binary files compile successfully, 
but execute improperly. 
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C Programming Guide ctype Functions 


The ctype Functions 


The file <ctype.h> defines a number of functions that classify 
ASCII characters. These functions indicate whether a character 
belongs to a certain character class, returning nonzero for true and 
zero for false. The following table defines ctype functions. 


Table 2-1. ctype Functions 


isalpha (c) a letter. 

isupper (c) upper-case. 

islower (c) lower-case. 

isdigit(c) a digit. 

alphanumeric, 

a white space character. 

a punctuation character. 

a printable character. 

a control character. 

an ASCII character (< 0x80). 


isalinum (c) 
isspace (c) 
ispunct (c) 
isprint(c) 
isentrl (c) 
isascii (c) 


qgQaqagagqagagagaa 


The white space characters are the space (0x20), tab (0x09), 
carriage return (0x0d), line-feed (0Ox0a), and form-feed (0x0c) 
characters. Punctuation characters are not control or alphanumeric 
characters. The printing characters are the space (0x20) through 
the tilde (0x7e). A control character is less than a space (0x20). 


Calling Sequence: 


#include <ctype.h> 


WORD ret; 

BYTE c; /* or WORD c; */ 
ret = isalpha(c); 
ret = isupper (c); 
ret = islower(c); 
ret = isdigit(c); 
ret = isalnum(c); 
ret = isspace(c); 
ret = ispunct(c); 
ret = isprint(c); 
ret = isentrl(c); 
ret = isascii(c); 
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Arauments: 
c the character to be classified 
Returns: 
—, a 
ret = 0 for false 
a ret <>0 for true 
Note: 
These functions are implemented as macros; arguments with 
side effects, such as *p++, work incorrectly in some cases. 
Bogus values return if arguments are not ASCII characters. 
For example, >0x7f. 
/ y 
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C Programming Guide end, etext, edata Locations 


The end, etext, edata Locations 


The linkage editor defines the labels end, etext, and edata as 
the first location past the BSS, text, and data regions, 
respectively. The program-break location, which is the last used 
location, is initially set to end. However, many library functions 
alter this location. sbrk(0) can retrieve the break. 
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exit, _exit Functions 


The exit, exit Functions 


SSeS ee ei sv ness 


The exit function passes control to CP/M-68K. An optional 
completion code, which CP/M-68K ignores, might return. exit 
deallocates all memory and closes any open files. exit also flushes 
the buffer for stream output files. 


The (exit function immediately returns control to CP/M-68K, 
without flushing or closing open files. 


Calling Sequence: 
WORD code; 


exit (code) ; ‘ 
_exit (code) ; 


Arguments: 


code optional return code 


Returns: 


no returns. 
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The fclose, fflush Functions 


gree aE A LE EI SE SE 


The fclose and fflush functions close and flush stream files. 
The stream address identifies the stream to be closed. 


Calling Sequence: 


WORD ret; 
FILE *stream; 


ret = fclose (stream); 
ret = fflush(stream); 


Arguments: 


stream the stream address 


Returns; 
0 successful 
-1 bad stream address or write failure 
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C Programming Guide feof, ferror, clearerr, fileno Functions 


The feof, ferror, clearerr, fileno Functions 


These functions manipulate file streams in a system- independent 


manner. ; 


The feof function returns nonzero if a specified stream is at 
end-of-file, and zero if it is not. 


The ferror function returns nonzero when an error has occurred 
on a specified stream. The clearerr function clears this error. 


This is useful for functions such as putw, where no error indication 
returns for output failures. 


The fileno function returns the file descriptor associated with 
an open stream. 


Calling Sequence: 


WORD ret; 

FILE *stream; 

WORD fd; 

ret = feof (stream); 
ret = ferror (stream); 


clearerr (stream); 
fd = fileno(stream); 


Arguments: 


stream the stream address 


Returns: 


‘ret a zero or nonzero indicator 
fd the returned file descriptor 
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The fopen, freopen, fdopen Functions 


The fopen, freopen, and fdopen functions associate an 1/0 
stream with a file or device. 


The fopen and fopena functions open an existing ASCII file for 
I/O as a stream. The fopenb function opens an existing binary file 
for I/O as a stream. 


The freopen and freopa functions substitute a new ASCII file 
for an open stream. The freopb function substitutes a new binary 
file for an open stream. 


The fdopen function associates a file that file descriptor 
opened, using open or creat, with a stream. 


Calling Sequence: 


FILE *fopen() ,fopena() ,fopenb(); 
FILE *freopen(),freopa(),freopb(); 
FILE *f£dopen (); 

FILE *stream; 

BYTE *name,*access; 


WORD fd; 

stream fopen (name , access) ; 
stream fopena (name, access) ; 
stream fopenb (name, access) ; 


stream freopa (name,access, stream) ; 
stream freopb (name,access, stream) ; 


= 
3 
stream = freopen(name,access,stream) ; 
= 
= 
stream = fdopen(fd,access) ; 


Arguments: 


name the null-terminated filename string 
stream the stream address 
access the access string: 


r read the file 
w write the file 
a append to a file 
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C Programming Guide fopen, freopen, fdopen Functions 


Returns: 


stream successful if stream address open 


0 unsuccessful 
foe Note: 
: UNIX programs that use fopen on binary files compile and 
link correctly, but execute improperly. 
Co * 
cor 
Sa 
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The fread, fwrite Functions 


The fread and fwrite functions transfer a stream of bytes 
between a stream file and primary memory. ; 


Calling Sequence: 


WORD nitems; 
BYTE *buff; 
WORD size; 
FILE *stream; 


nitems = fread(buff,size,nitems,stream) ; 
nitems = fwrite(buff,size,nitems,stream) ; 


Arguments: 


buff the primary memory buffer address 
size the number of bytes in each item 
nitems the number of items to transfer 
stream an open stream file 


Returns: ® 
nitems the number of items read or written 
0 error, including EOF 
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The fseek, ftell, rewind Functions 


The fseek, ftell, and rewind functions position a stream file. 


The fseek function sets the read or write pointer to an 
arbitrary offset in the stream. The rewind function sets the read 
or write pointer to the beginning of the stream. These calls have 
no effect on the console device or the listing device. 


The ftell function returns the present value of the read or 


write pointer in the stream. ‘This call returns a meaningless value 
for nonfile devices. , 


Calling Sequence: 


WORD ret; 

FILE *stream; 

LONG offset,ftell(); 
WORD ptrname; 


ret = fseek(stream,offset,ptrname); 
ret = rewind(stream); 
offset = ftell (stream); 


Arguments: 


stream the stream address 
offset a signed offset measured in bytes 
ptrname the interpretation of offset: 


0 => from beginning of file 


l => from current position 
2 => from end of file 


Returns: 


ret 0 for success, -1 for failure 
offset present offset in stream 


Note: 


ASCII file seek and tell operations do not account for 
carriage returns that are eventually deleted. CTRL-Z 
characters at the end of the file are correctly handled. 
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C Programming Guide getc, getchar, fgetc, getw, getl Functions 


The getc, getchar, fgetc, getw, getl Functions 


The getc, getchar, fgetc, getw, and getl functions perform 
input from a stream. 


The getc function reads a single character from an input 
stream. This function is implemented as a macro in <stdio.h>, and 
arguments should not have side effects. 


The getchar function reads a single character from the standard 
input. It is identical to getc(stdin) in all respects. 


The fgetc function is a function implementation of getc, used 
to reduce object code size. 


The getw function reads a 16-bit word from the stream, high 
byte first. This is compatible with the read function call. No 
Special alignment is required. 


The getl function reads a 32-bit long from the stream, in 68000 
byte order. No special alignment is required. 


Calling Sequence: 


WORD ichar; 

‘PILE *stream; 

WORD iworad; 

LONG ilong,getl(); 


ichar = getc (stream); 
ichar = getchar (); 

ichar = fgetc (stream); 
iword = getw(stream); 
ilong = getl (stream); 


Arguments: 


stream the stream address 


Returns: 


ichar character read from stream 
iword word read from stream 
ilong longword read from stream 
-1 on read failures 
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C Programming Guide getc, getchnar, tgetc, getw, geti runctions 


Note: 
Error return from getchar is incompatible with UNIX prior 
to version 7. Error return from getl or getw is a valid 
value that might occur in the file normally. Use feof or 
ferror to detect end-of-file or read errors. 
a aaa 
ee 
be 
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The getpass Function 


The getpass function reads a password from the console device. 
A prompt is output, and the input read without echoing to the 
console. A pointer returns to a 0- to 8-character null-terminated 
string. 


Calling Sequence: 


BYTE *prompt; 
BYTE *getpass; 
BYTE “pass; 


pass getpass (prompt); 


Ar guments: 


prompt a null-terminated prompt string 


Returns: 


pass points to the password read 


Note: 


The return value points to static data whose content is 
overwritten by each call. 
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The getpid Function 


The getpid function is a bogus routine that returns a false 
process ID. This routine is strictly for UNIX compatibility; serves 
no purpose under CP/M-68K. The return value is unpredictable in 
some implementations. ss 


Calling Sequence: 
WORD pid; 


pid = getpid(); 


Ar gumen ts: 


‘ 


no arguments. 


Returns: 


pid false process ID 


~ 
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The gets, fgets Functions 


The gets and fgets functions read strings from stream files. 
fgets reads a string including a newline (line-feed) character. 
gets deletes the newline, and reads only from the standard input. 
Both functions terminate the strings with a null character. 


You must specify a maximum count with fgets, but not with gets. 
This count includes the terminating null character. 


Calling Sequence: 


BYTE *addr; 

BYTE *s; 

BYTE *gets(),*fgets (); 
WORD n; 

FILE *stream; 


addr = gets(s); 
addr = fgets(s,n,stream); 


Arguments: 
s the string buffer area address 
n the maximum character count 
stream the input stream 


Returns: 


addr the string buffer address 
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The index, rindex Functions 


The index and rindex functions locate a given character in a 
ey string. index returns a pointer to the first occurrence of the 
character. rcindex returns a pointer to the last occurrence. 


Calling Sequence: 


BYTE c; 

BYTE *s; 

BYTE *ptr; 

BYTE *index() ,*rindex(); 


ptr = index(s,c); 
ptr = rindex(s,c); 


Arguments: 


s a null-terminated string pointer 
ec the character for which to look 
Returns: 
a Fe 
ae ptr the desired character address 
0 character not in the string 
. ~~” : 
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The isatty Function 


A CP/M-68K program can use the isatty function to determine 
whether a file descriptor is attached to the CP/M-68K console device 
(CON:). 


Calling Sequence: 


WORD fd; 
WORD ret; 


ret = isatty (fd); 


Ar gumen ts: 


fd an open file descriptor 
Returns: 
1 fd attached to CON: 
0 fd not attached to CON: 
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The lseek, tell Functions 
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The lseek function positions a file referenced by the file 
we. descriptor to an arbitrary offset. Do not use this function with 
Stream files, because the data in the stream buffer might be 

invalid. Use the fseek function instead. 


The tell function determines the file offset of an open file 
descriptor. 


Calling Sequence: 


WORD fd; 
WORD ptrname; 
LONG offset,lseek(),tell(),ret; 


= lseek (fd,offset,ptrname) ; 
= tell (fd); 


Arguments: 


—~ fd the open file descriptor 
i offset a signed byte offset in the file 
cS aga ptrname the interpretation of offset: 


0 => from the beginning of the file 
l => from the current file position 
2 => from the end of the file 


ee A Neneh Po tne etme Mee thee thet me ote coe 


F Returns: 


ret resulting absolute file offset 
=1 error 


Note: 


Incompatible with versions 1 through 6 of UNIX. 
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The mktemp Function 
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The mktemp function creates a temporary filename. The calling 
argument is a character string ending in 6 X characters. The 
temporary filename overwrites these characters. ; fs 


Calling Sequence: 
BYTE *string; 
BYTE *mktemp(); 


string = mktemp(string) 


Arguments: 


string the address of the template string 


Returns: 


string the original address argument 
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The open, opena, openb Functions 
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The open and opena functions open an existing ASCII file by 
file descriptor. The openb function opens an existing binary file. 
The file can be opened for reading, writing, or updating. 


Calling Sequence: 


BYTE *name; 

WORD mode; 

WORD fd; 

fd = open (name,mode) ; 
fd = opena (name ,mode); 
fd = openb(name,mode); 


Arguments: 


name the null-terminated filename string 
mode the access desired: 


0 => Read-Only 
1 => Write-Only 
2 => Read-Write (update) 


Returns: 


fd the file descriptor for accessing the file 
=i open failure 


Note: 


UNIX programs that use binary files compile correctly, but 
execute improperly. 
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fhe perror Function 
enema 


: The perror function writes a short message on the standard 
error file that describes the last system error encountered. First 
an argument string prints, then a colon, then the message. 

CP/M-68K C simulates the UNIX notion of an external variable, 
errno, that contains the last error returned from the operating 
system. Appendix A contains a list of the possible values of errno 
and of the messages that perror prints. 


Calling Sequence: 


BYTE *s; 
WORD err; 
err = perror(s); 


Arguments: 
s the prefix string to be printed 


Returns; 


err value of "errno" before call & 


Notes: 


Many messages are undefined on CP/M-68K. 
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The printf, fprintf, sprintf Functions 
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The printf functions format data for output. The printf 

-function outputs to the standard output stream. The fprintf 

function outputs to an arbitrary stream file. The sprintf function 
Outputs to a string (memory). 


Calling Sequence: 


WORD ret; 

BYTE *fmt; 

FILE *stream; 

BYTE *string; 

BYTE *sprintf(),rs; 

/* Args can be any type */ 


ret = printf (fmt,argl,arg2 ...); 
ret = fprintf(stream,fmt,argl,arg2 ...); 
rs = sprintf (string,fmt,argl,arg2 


eee)? 


Arguments: 


fmt format string with conversion specifiers 
argn data arguments to be converted 

stream ‘output stream file 

String buffer address 


Returns: 
ret number of characters output 
-1 if error 
rs buffer string address 


‘mull. if error 


Conversion Operators 


A percent sign, %, in the format string indicates the start of 
a conversion operator. Values to be converted come in order from 
the argument list. Table 2-2 defines the valid conversion 


operators. 


La See | oe eee ee: 


Sea Re age P eT PE Page GRE eT Wn gn ae, ME aR OEE EARS Rice ie. ec Ee ES 8S se 


C Programming Guide printf, fprintf, sprintf Functions 


Table 2-2. Conversion Operators 


Converts a binary number to decimal ASCII and 
inserts in output stream. 


Converts a binary number to octal ASCII and 
inserts in output stream. 


Converts a binary number to hexadecimal ASCII 
and inserts in output stream. 


Uses the argument as a single ASCII character. 
Uses the argument as a pointer to a null- 


terminated ASCII string, and inserts the string 
into the output stream. 


Converts an unSigned binary number to decimal 
ASCII and inserts in output stream. 


Prints a % character, 


You can insert the following optional directions between the &% 
character and the conversion operator: 


eA minus sign justifies the converted output to the left, 
instead of the default right justification. 


e A digit string specifies a field width. This value gives the 
minimum width of the field. If the digit string begins with a 
0 character, zero padding results instead of blank padding. An 
asterisk takes the value of the width field as the next 
argument in the argument list. 


@ A period separates the field width from the precision string. 


eA digit string specifies the “precision for floating-point 
conversion, which is the number of digits following the decimal 
point. An asterisk takes the value of the precision field from 
the next argument in the argument list. 


@ The character 1 or L specifies that a 32-bit long value be 
converted. A capitalized conversion code does the same thing. 
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The putc, putchar, fputc, putw, putl Functions 


The putc, putchar, fputc, putw, and putl functions output 
characters and words to stream files. 


The putc function outputs a single 8-bit character to a stream 
file. This function is implemented as a macro in <stdio.h>, so do 
not use arguments with side effects. The fputc function provides 
the equivalent function as a real function. 


The putchar function outputs a character to the standard output 
stream file. This function is also implemented as a macro in 
<stdio.h>. Avoid using side effects with putchar. 


The putw function outputs a 16-bit word to the specified stream 


file. The word is output high byte first, compatible with the write 
function call. 


The putl function outputs a 32-bit longword to the stream file. 
The bytes are output in 68000 order, as with the write function 
call. 


Calling Sequence: 


BYTE c; 

FILE *stream; 

WORD w,ret; 

LONG lret,putl(),1; 


ret = putc(c,stream); 
ret = fputc(c,stream); 
ret = putchar(c); 
ret = putw(w,stream) >; 
lret = putl(1,stream); 
Arguments: 2 
c the character to be output 
stream the output stream address 
w the word to be output 
1 the long to be output 
Returns: 
ret the word or character output 
lret the long output with putl 
-1 an output error 
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Note: 


A -l return from putw or putl is a valid integer or long 
value. Use ferror to detect write errors. 
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The puts, fputs Functions 
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The puts and fputs functions output a null-terminated string to 
an output stream. 


The puts function outputs the string to the standard output, 
and appends a newline character. 


The fputs function outputs the string to a named output stream. 
The fputs function does not append a newline character. 


Neither routine copies the trailing null to the output stream. 


Calling Sequence: 


WORD ret; 

BYTE *s; 

FILE *stream; 

ret = puts(s); 

ret = fputs(s,stream); 
Arguments: 


ise s the string to be output 
: stream the output stream 


Returns: 


ret the last character output 
-1 error 


Note: 


‘The newline incompatibility is required for compatibility 
with UNIX. 
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The qsort Function 


The qsort function is a quick sort routine. You supply a 
vector of elements and a function to compare two elements, and the 
vector returns sorted. 


Calling Sequence: 


WORD ret; 

BYTE *base; 
WORD number; 
WORD size; 

WORD compare (); 


ret = qsort (base,number ,size,compare) ; 


Arguments: 


base the base address of the element vector 
number the number of elements to sort 
size size of each element in bytes 


compare the address of the comparison function 
This function is called by the following: 
ret = compare (a,b); 


The return is: 


<0 if a<b 
=0 ifae=pb 
> 0 if a>b 
Returns: 
0 always © 
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The rand, srand Functions 
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The rand and srand functions constitute the C language random 
number generator. Call srand with the seed to initialize the 


a generator. Call rand to retrieve random numbers. The random 
is numbers are C int quantities. 
Calling Sequence: 
WORD seed; 
WORD rnum; 
rnum = srand(seed); 
rnum = rand(); 
Arguments: 
seed an int random number seed 
Returns: 
rnum desired random number 
as 
aes 
Loan 
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The read Function 


The read function reads data from a file opened by the file 
descriptor using open or creat. You can read any number of bytes, 
Starting at the current file pointer. 


Under CP/M-68K, the most efficient reads begin and end on 128- 
byte boundaries. 


Calling Sequence: 


WORD ret; 
WORD fd: 
BYTE *buffer; 
WORD bytes; 


ret = read(fd,buffer ,bytes); 


Arguments: 
fd a file descriptor open for read 
buffer the buffer address 
bytes the number of bytes to be read 
Returns: 


ret number of bytes actually read 
“1 error 
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The scanf, fscanf, sscanf Functions 


The scanf functions convert input format. The scanf function 


— reads from the standard input, fscanf reads from an open stream 


file, and sscanf reads from a null-terminated string. 


Calling Sequence: 


BYTE *format,*string; 

WORD nitems; 

FILE *stream; 

/* Args can be any type */ 


nitems scanf(format,argl,arg2 ...); 


nitems = fscanf(stream,format,argl,arg2 ...); 
nitems = sscanf(string,format,argl,arg2 ...); 


Arguments: 


format the control string 
argn pointers to converted data locations 


fon stream an open input stream file 


String null-terminated input string 


Returns: 


nitems the number of items converted 
-1 I/O error 


Control String Format 


The control string consists of the following items: 


e Blanks, tabs, or newlines (line-feeds) that match optional 
white space in the input. 


@ An ASCII character (not $) that matches the next character of 
the input stream. 


e Conversion specifications, consisting of a leading %, an 
= Optional * (which suppresses assignment), and a conversion 
character. The next input field is converted and assigned to 
the next argument, up to the next inappropriate character in 
the input or until the field width is exhausted. 
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Conversion characters indicate the interpretation of the next 
input field. The following table defines valid conversion 
characters. 


fable 2-3. Valid Conversion Characters 


Pemeesee [ening 


A single % matches in the input at this 
point; no conversion is performed. 


d Converts a decimal ASCII integer and stores 
it where the next argument points. 


° Converts an octal ASCII integer. 


x Converts a hexadecimal ASCII integer. 


A character string, ending with a space, is 
input. The argument pointer is assumed to 
point to a character array big enough to 
contain the string and a trailing null 
character, which are added. 


Stores a Single ASCII character, including 
spaces. To find the next nonblank character, 
use $%ls. 


Stores a string that does not end with 
spaces. The character string is enclosed in 
brackets. If the first character after the 
left bracket is not “*, the input is read 
until the scan comes to the first character 
not within the brackets. If the first 
character after the left bracket is *, the 
input is read until the first character 
within the brackets. 


Note: 
You cannot determine the success of literal matches 
and suppressed assignments. 
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The setjmp, longjmp Functions 


The setjmp and longjmp functions execute a nonlocal GOTO. The 
setjmp function initially specifies a return location. You can then 
call longjmp from the procedure that invoked setjmp, or any 
subsequent procedure. longjmp simulates a return from setjmp in the 
procedure that originally invoked setjmp. A setjmp return value 
passes from the longjmp call. The procedure invoking setjmp must 
not return before longjmp is called. 


Calling Sequence: 


#include <setjmp.h> 
WORD xret,ret; 
jmp_buf env; 


xret = setjmp(env); 


longjmp (env, ret); 


Arguments: 

env contains the saved environment 

ret the desired return value from setjmp 
Returns: 

xret 0 when setjmp invoked initially 

copied from ret when longjmp called 

Note: 

awkward 
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The signal Function 


The signal function connects a C function with a 68000 
exception condition. Each possible exception condition is indicated 
by a number. The following table defines exception conditions. 


Table 2-4. 68000 Exception Conditions 


Prete [emintes 


Illegal instruction trap. Includes 
illegal instructions, privilege violation, 
and line A and line F traps. 


Trace trap. 


Trap instruction other than 2 or 3; used 
by BDOS and BIOS. 


Arithmetic traps: zero divide, CHK 
instruction, and TRAPV instruction. 


BUSERR (nonexistent memory) or addressing 
(boundary) error trap. 


All other values are ignored for compatibility with UNIX. 
Returning from the procedure activated by the signal resumes 


normal processing. The library routines preserve registers and 
condition codes. 


Calling Sequence: 


WORD ret,sig; 
WORD func(); 


ret = signal(sig,func); 


Arguments: 


sig the signal number given above 
func the address of ac function 
Returns: 
ret 0 if no error, -1 if sig out of range 
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The strceat, strncat Functions 
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The strcat and strncat functions concatenate strings. The 
Strcat function concatenates two null-terminated strings. The 
strncat function copies a specified number of characters. 


Calling Sequence: 


BYTE *sl,*s2,*ret; 
BYTE *strcat(),*strncat(); 
WORD n; 


ret 
ret 


strcat(Sl1,s2); 
strncat(sl1,s2,n); 


Arguments: 


sl the first string 

s2 the second string, appended to sl 

n the maximum number of characters in sl 
Returns: 

ret = a pointer to sl 
Note: 


The strcat (sl,sl) function never terminates and usually 
destroys the operating system because the end-of-string 
marker is lost, so strcat continues until it runs out of 


memory, including the memory occupied by the operating 
system. 
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The strcmp, strncmp Functions 
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The stremp and strnemp functions compare Strings. The strcemp 
function uses null termination, and strncemp limits the comparison to 
a specified number of characters. 


Calling Sequence: 


BYTE *sl1,*s2; 
WORD val,n; 


val = stremp(sl1,S2); 
val = strnemp(s1,52,n); 


Arguments: 


sl a null-terminated string address 
$2 a null-terminated string address 
n the maximum number of characters to compare 
Returns: 
val the comparison result: 
<0 = sl < s2 
= 0 => sl = 82 
> 0 => sl > S2 
Note: 
Different machines and compilers interpret the characters 
as signed or unsigned. 
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The strcpy, strncpy Functions 
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The strcpy and strncpy functions copy one null-terminated 
string to another. The strcpy function uses null-termination, while 


| 
4 
H 
| a strncpy imposes a maximum count on the copied string. 
Calling Sequence: 
BYTE *sl,*s2,*ret; 
; BYTE *strcpy(),*strncpy (); 
i WORD n; i 
q 
j ret = strcpy(sl,S2); 
ret = strncpy(sl1,s2,n); 
i Arguments: 
i 
i sl the destination string 
j s2 the source string 
| n the maximum character count 
Returns: 
f : 
age ret the address of sl 
Note: 
If the count is exceeded in strncpy, the destination string 
is not null-terminated. 
ike 
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The strien Function 
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The strlen function returns the length of a null-terminated 
string. x 


Calling Sequence: 
BYTE *s; 
WORD len; 


len = strien(s); 


Arguments: 


s the string address 
Returns: 
len the string length 
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The swab Function 
a eet i ee 


The swab function copies one area of memory to another. The 
high and low bytes in the destination copy are reversed. You can 
use this function to copy binary data from a PDP-11™ or VAX™ to the 
68000. The number of bytes to swap must be even. 
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Calling Sequence: 
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WORD ret; 
BYTE *from,*to; 
WORD nbytes; 


ret = swab(from,to,nbytes) ; 
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Arguments: 


from the address of the source buffer 
to the address of the destination 
nbytes the number of bytes to copy 
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Returns: 
oF t 1 0 
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The ttyname Function 


The ttyname function returns a pointer to the null-terminated 
filename of the terminal device associated with an open file 
descriptor. 


Calling Sequence: 


BYTE *name,*ttyname (); 
WORD fd; 


name = ttyname (fd); 


Arguments: 


fda an open file descriptor 


Returns: 


A pointer to the null-terminated string CON: if the file 
descriptor is open and attached to the CP/M-68K console 
device. Otherwise, zero (NULL) returns. 
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The ungetc Function 


The ungetc function pushes a character back to an input stream. 
The next getc, getw, or getchar operation incorporates the 
character. One character of buffering is guaranteed if something 
has been read from the stream. The fseek function erases any 
pushed-back characters. You cannot ungetc EOF (~1l). 


Calling Sequence: 


BYTE oc; 
FILE *stream; 
WORD ret; 


ret = ungetc(c,stream); 


Arguments: 


c the character to push back 
stream the stream address 


Returns: 
ret c if the character is successfully pushed back 
“1 error 
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fhe unlink Function 


The unlink function deletes a named file from the file system. 
The removal operation fails if the file is open or nonexistent. 


Calling Sequence: 


WORD ret; 
BYTE *name; 


ret = unlink (name); 


Ar gumen ts: 


name the null-terminated filename 
Returns: 
0 success 
-1 failure 
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The write Function 


The write function transfers data to a file opened by file 
descriptor. Transfer begins at the present file pointer, as set by” 
previous transfers or by the lseek function. You can write any 
arbitrary number of bytes to the file. The number of bytes actually 
written returns. If the number of bytes written does not match the 
number. requested, an error occurred. 


Under CP/M-68K, the most efficient writes begin and end on 128- 
byte boundaries. 


Calling Sequence: 


WORD fd; 

BYTE *buffer; 
WORD bytes; 
WORD ret; 


ret = write(fd,buffer,bytes); 


Arguments: 


fd the open file descriptor 
buffer the starting buffer address 
bytes the number of bytes to write 


Returns: 


ret the number of bytes actually written 
-1 errors 


Notes: 
Due to the buffering scheme used, all data is not written 
to the file until the file is closed. 


End of Section 2 
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Section 3 
C Style Guide 


To make your C language programs portable, readable, and easy 
to maintain, follow the stylistic rules presented in this section. 
However, no rule can predict every situation; use your own judgment 
in applying these principles to unique cases. 


3.1 Modularity 


Modular programs reduce porting and maintenance costs. 
Modularize your programs, so that all routines that perform a 
specified function are grouped in a single module. This practice 
has two benefits: first, the maintenance programmer can treat most 
modules as black boxes for modification purposes; and second, the 
nature of data structures is hidden from the rest of the program. 
In a modular program, you can change any major data structure by 
changing only one module. 


3.1.1 Module Size 

A good maximum size for modules is 500 lines. Do not make 
modules bigger than the size required for a given function. 
3.1.2 Intermodule Communication 

Whenever possible, modules should communicate through procedure 
calls. Avoid global data areas. Where one or more compilations 
require the same data structure, use a header: file. 
3.1.3 Header Files 

In separately combined files, use header files to define types, 


symbolic constants, and data structures the same way for all 
modules. The following list gives rules for using header files. 


@ Use the '#include "file.h"* format for header files that are 
project-specific. Use ‘tinclude <file.h>' for system-wide 
files. Never use device or directory names in an include 
statement. 


e@ Do not nest include files. 
@ Do not define variables other than global data references ina 


header file. Never initialize a global variable in a header 
file. 
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@ When writing macro definitions, put parentheses around each use 
of the parameters to avoid precedence mix-ups. 


3.2 Mandatory Coding Conventions 


To make your programs portable, you must adhere strictly to the 
conventions presented in this section. Otherwise, the following 
problems can occur: 


@ The length of aC int variable varies from machine to machine. 
This can cause problems with representation and with binary I/O 
that involves int quantities. 


@ The byte order of multibyte binary variables differs from 
machine to machine. This can cause problems if a piece of code 
views a binary variable as a byte stream. 


e@ Naming conventions and the maximum length of identifiers differ 
from machine to machine. Some compilers do not distinguish 
between upper- and lower~case characters. 


e@ Some compilers sign-extend character and short variables to int 
during arithmetic operations; some compilers do not. 


@ Some compilers view a hex or octal constant as an unsigned int; 
some do not. For example, the following sequence does not 
always work as expected: 


LONG data; 


printf ("sld\n", (data & OxfffE£)); 


The. printf statement prints the lower 16 bits of the long data 
item data. However, some compilers sign-extend the hex 
constant Oxffft. 


@e You must be careful of evaluation-order dependencies, 
particularly in compound BOOLEAN conditions. Failure to 
parenthesize correctly can lead to incorrect operation. 


3.2.1 Variable and Constant Names 


Local variable names should be unique to eight characters. 
Global variable names and procedure names should be unique to six 
characters. All variable and procedure names should be completely 
lower-case. 
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3.2 Mandatory Coding Conventions 


Usually, names defined with a #define statement should be 
entirely upper-case. The only exceptions are functions defined as 
macros, such as getc and isascii. These names should also be unique 
to eight characters. 


You should not redefine global names as local variables within 
a procedure. 


3.2.2 Variable Typing 


Using standard types is unsafe in programs designed to be 


portable due to the differences in C compiler standard type © 


definitions. Instead, use a set of types and storage classes 
defined with typedef or #define. The following tables define C 
language types ..and storage classes. 


Table 3-1. Type Definitions 


LONG signed long (32 bits) 
WORD» signed short (16 bits) 


UWORD _unsigned short (16 bits) 
BOOLEAN short (16 bits) 
BYTE signed char (8 bits) 
UBYTE unsigned char (8 bits) 
VOID void (function return) 

DEFAULT int (16/32 bits) 


Table 3-2. Storage Class Definitions 


register variable 
auto variable 


module static variable 
global variable definition 
global variable reference 


Additionally, you must declare global variables at the 
beginning of the module. Define local variables at the beginning of 
the function in which they are used. You must always specify the 


storage class and type, even though the C language does not require 
this. 
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'3.2.3 Expressions and Constants 


Write all expressions and constants to be implementation- 
independent. Always use parentheses to avoid ambiguities. For 
example, the construct 


if(c = getchar() s= ‘\n') 


does not assign the value returned by getchar to c. Instead, the 
value returned by getchar is compared to '\n', and c receives the 
value 0 or 1 (the true/false output of the comparison). The value 
that getchar returns is lost. Putting parentheses around the 
assignment solves the problem: 


if((e = getchar()) == ‘\n') 


Write constants for masking, so that the underlying int size is 
irrelevant. In the following example, 


LONG data; 


print£("ld\n", (data & Oxf£f£L); 


the long masking constant solves the previous problem for all 
compilers. Specifying the one's complement often yields the desired 
effect, for example, ~Oxff instead of Oxff00. 


For portability, character constants must consist of a single 
character. Place multicharacter constants in string variables. 


Commas that separate arguments in functions are not operators. 
Evaluation order is not guaranteed. For example, the following 
function call 


print£("%d d\n", it++,i++); 


can perform differently on different machines. 


3.2.4 Winter Arithmetic 


Do not manipulate pointers as ints or other arithmetic 
variables. C allows the addition or subtraction of an integer to or 
from a pointer variable. Do not attempt logical operations, such as 
AND or OR, on pointers. A pointer to one type of object can convert 
to a pointer to a smaller data type with complete generality. 
Converting a pointer to a larger data type can yield alignment 
problems. 
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You can test pointers for equality with other pointer variables 
and constants, notably NULL. Arithmetic comparisons, such as >=#, 
do not work on all compilers and can generate machine-dependent 
code. 


When you evaluate the size of a data structure, remember that 
the compiler might leave holes in a data structure to allow for 
alignment. Always use the sizeof operator. 


3.2.5 String Constants 


Allocate strings so that you can easily convert programs to 
foreign languages. The preferred method is to use an array of 
pointers to constant strings, which is initialized in a separate 
file. This way, each string reference then references the proper 
element of the pointer array. 


Never modify a specific location in a constant string, as in 
the following example: 


BYTE string{] ="BDOS Error On x:"; 


string[{14] = ‘'A'; 


Fore ign-language equivalents are not likely to be the same length as 
the English version of a message. 


Never use the high-order bit of an ASCII string for bit flags. 
Extended character sets make extensive use of the characters above 
Ox7F. 


3.2.6 Data and BSS Sections 


Usually, C programs have three sections: text (program 
instructions), data (initialized data), and BSS (uninitialized 
data). Avoid modifying initialized data if at all possible. 
Programs that do not modify the data segment can aid the swapping 
performance and disk utilization of a multiuser system. 


Also, if a program does not modify the data segment, you can 
place the program in ROM with no conversion. This means that the 
Program does not modify initialized static variables. This 
restriction does not apply to the modification of initialized 
automatic variables. 
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3.2.7 Module Layout 


The following list tells you what to include in a module. 


At the beginning of the file, place a comment describing the 
following items: 


- the purpose of the module 

- the major outside entry points to the module 

- any global data areas that the module requires 
- any machine or compiler dependencies 


Include file statements. 
Module-specific #define statements. 


Global variable references and definitions. Every variable 
should include a comment describing its purpose. 


Procedure definitions. Each procedure definition should 
contain the following items: 


- A comment paragraph, describing the procedure's function, 
input parameters, and return parameters. Describe any 
unusual coding techniques here. 


- The procedure header. The procedure return type must be 
explicitly specified. Use VOID when a function returns no 
value. -.. : 


- Argument definitions. You must explicitly declare storage 
class and variable type. 


- Local variable definitions. Define all local variables 
before any executable code. You must explicitly declare 
storage class and variable type. 


- Procedure code. 


Refer to Appendix C for’ a sample program. 


3.3 Suggested Coding Conventions 


The following suggestions increase program portability and make 


programs easier to maintain. 


@ Keep source code within an 80-character margin for easier 


screen editing. 


@ Use a standard indention technique, such as the following: 


C Programming Guide 3.3 Suggested Coding Conventions 


~- Begin statements in a procedure one tab stop (column eight) 
from the left margin. 


- Indent statements controlled by an if, else, while, do, or 
for one tab stop. If you require multiple nested 
indentions, use two spaces for each nesting level. Avoid 
going more than five levels deep. 


- Place the brackets surrounding each compound statement on a 
separate line, aligned with the indention of the controlling 
statement. For example, 


a (i=0; 1<MAXNUM; i++) 


j = compute (i); 
if (3 > UPPER) 

j = UPPER; 
output (j); 


- Place a null statement controlled by an if, else, while, for, 
or do on a separate line, indented for readability. 


@ To document your code, insert plenty of comments. If your code 
is particularly abstruse, inserting comments helps clarify it. 
F: @ Put all maintenance documentation in the source code itself. 
If you do not, the documentation will not be updated when the 
code changes. 
@ Use blank lines, form-feeds, and white space to improve 
readability. 


End of Section 3 
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Appendix A 
CPM-68K Error Codes 


The perror function and the errno external variable determine 


~ of the cause of an error during a CP/M-68K system call. The include 


file <errno.h> contains symbolic definitions for the errors that 
CP/M-68K returns. The following table lists error numbers, symbolic 
names, and messages available from perror. 


Table A-1. CP/M-68K Error Codes 


[weno [tone | ineror noanese 


- Error Undefined on CP/M-68K 
- Error Undefined on CP/M-68K 
ENOENT No Such File 
- Error Undefined on CP/M-68K 
- Error Undefined on CP/M-68K 
EIO I/O Error 
- Error Undefined on CP/M-68K 
E2B1iIG Arg List too Long . 
Error Undefined on CP/M-68K 
Bad file Number 
Error Undefined on CP/M-68K 
Error Undefined on CP/M-68K 
Not enough core 
Permission denied 
Error Undefined on CP/M-68K 
Error Undefined on CP/M-68K 
Error Undefined on CP/M-68K 
Error Undefined on CP/M-68K 
Error Undefined on CP/M~68K 
Error. Undefined on CP/M-68K 
Error Undefined on CP/M-68K 
Error Undefined on CP/M-68K 
Invalid argument 
File table overflow 
Too many open files 
Not a typewriter 
Error Undefined on CP/M-68K 
File too big 
No space left on device 
Error Undefined on CP/M-68K 
Read-Only file system 
Error Undefined on CP/M~68K 
Error Undefined on CP/M~-68K 
Error Undefined on CP/M-68K 
Error Undefined on CP/M-68K - 
No directory space 
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The file <errno.h> also includes the names for all errors 
defined with UNIX V7. Therefore, programs that reference these 
definitions need not be changed. 


End of Appendix A 
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Appendix B 
Customizing the C Compiler 


Compiling a C program requires three compiler passes. The 
output of the compiler is assembly language, which must be assembled 
and linked to produce a program that runs. The compiler, assembler, 
linker load modules, C library, and the system include files need a 
substantial amount of disk storage space, minimizing storage space. 
This appendix discusses compiler operation and suggests ways to 
minimize the disk storage requirements for compiling. 


B.1 Compiler Operation 


The C compiler has three components: the preprocessor (CP68), 
the parser (C068), and the code generator (C168). The assembler 
(AS68) and the linker (LO68) also help generate an executable 
program. The following list tells you how these components operate. 


1) The preprocessor, CP68, takes the original source file and 
produces a file with all #define and #include statements 
resolved. The preprocessor command line takes the form: 


CP68 [-I d:] file.C file.I 


The -I flag indicates that the next argument is a CP/M-68K 
drive specification. This drive is used for all library 
include statements of the form #include <file>. Drive 
specifications can also appear in the filename portion of 
an tinclude statement, but this procedure is not 
recommended. File.C is the source file, and file.I is the 
output file. 


2) The parser, C068, takes the file produced by the 
preprocessor and creates an intermediate code file. The 
command line takes the form: 


C068 file.I file.IC file.ST 


File.I is the output from the preprocessor. File.IC is the 
intermediate code file that C168 uses. File.ST is a 
temporary file that collects constant data for inclusion at 
the end of the intermediate code file. 
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3) 


4) 


5) 


The code generator, C168, takes the intermediate code file 
from C068 and produces an assembly-language source file. 
The command line takes the form: 


C168 file.Ic file.S [-LD) 


File.IC is the intermediate code output from CO68. File.s 
is the assembly-language output file. The -L flag 
indicates that the compilation assumes all address 
variables are 32 bits. The default is 16-bit addresses. 
The -D flag causes the compiler to include the line numbers 
from the source file (file.C) as comments in the generated 
assembly language. This is useful for debugging. 


The assembler, AS68, translates the compiler output to a 
form that the linkage editor can use. The command line 
takes the form: 


AS68 -L -U [-F d:] [-S d:] file.S 


The -L option indicates to the linkage editor that 
addresses are considered 32-bit quantities. The -U option 
means that undefined symbols are considered external 
references. The -F option specifies a drive that the 
assembler uses for temporary files. The -S option 
specifies a drive that the assembler uses for the 
initialization file (AS68SYMB.DAT). File.S is the output 
of C168, and file.O is produced by the assembler. 


The linker, LO68, produces an executable file from the 
output of one or more assembler runs. You must also 
include a start-up file and the C library when linking C 
programs. The linker command line takes the form: 


LO68 -R [-F d:] -O file.68K S.O file.O clib 


The --R option specifies that the file be relocatable. 
Relocatable files run on any CP/M-68K system. The -F 
option allows you to place linker temporary files on a disk 
Grive other than the default. The -O file.68K construct 
makes the linker place the executable output in file.68K. 
S.0 is the run-time start-up routine. You must include 
this file as the first file in every C program link. 
File.O is the output of the assembler. Specify multiple 
files between S.O and clib if you want separate 
compilation. clib is the C library file. 
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{ 
B.2 Supplied submit Piles 

CP/M-68K includes two submit files, c.sub and clink.sub, that 
compile and link C programs (see Section 1.1). Usually, these files 


i are located on the default drive. However, you can edit these files 
to specify different disk drives for any of the following drives: 


e The disk drive on which the compiler passes, assembler, and 
linker reside. 


e@ The disk drive that the include <file> statements in the C 
preprocessor reference. 


e The disk drive with the assembler initialization file. 


e The disk drive on which the assembler and linker create 
temporary files. 


@ The disk drive containing the C library file. 


B.3 Saving Disk Space 
You can do the following things to conserve disk space: 
@ Use the reloc utility on all the load modules, the compiler,. 
f assembler, linker, and editor. This significantly reduces file 


Ace size and load time. 


@ Place all the load modules on one disk and use another disk for 
sources and temporary files. This requires two drives. 


e On single-density disk systems, you must place the C library 
file and linker on a separate disk and swap disks before 
linking. 

B.4 Gaining Speed 
Along with the items in Section B.3, you can speed compilation 
by implementing the following: 

e Put the assembler temp files on a different drive from the 


source and object files. 


@ Put the linker temp files on a different drive from the object 
input, C library, and load module output. 
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@ Use the linker -S (Suppress symbol table) and -T (absolute load 
module) switches in place of the -R flag. If you do this, the 
resulting program cannot run on an arbitrary CP/M-68K system. 


End of Appendix B 
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Sample C Module 
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The modules in this appendix are written and documented in C 
code that follows the style conventions discussed in Section 3. 


[RAAAHARREEEREEERREERERRARRERREEREREREREERRERRERREREEEEEREREERKRRERKERHARRHREE / 


/* */ 
/* ~Printf Module */ 
/* ew wma mamas es wan as een ences * / 
/* */ 
/* This module is called through the single entry point "_printf" to */ 
/* perform the conversions and output for the library functions: */ 
/* ; Wy, 
/* printf - Pormatted print to standard output */ 
/* fprint£f - Formatted print to stream file */ 
/* sprintf - Formatted print to string «/ 
/* */ 
/* The calling routines are logically a part of this module, but are */ 
/* compiled separately to save space in the user's program when only */ 
/* one of the library routines is used. */ 
/* */ 
/* The following routines are present: */ 
/* w/ 
/* _printf Internal printf conversion / output */ 
/* _prnts Octal conversion routine «/ 
/* _prntx Hex conversion routine */ 
/* __conv Decimal ASCII to binary routine */ 
/* _putstr Output character to string routine */ 
/* _prntl Decimal conversion routine */ 
/* a7, 
/* The following routines are called: «/ 
7* */ 
/* strlen Compute length of a string */ 
/* pute Stream output routine . «/ 
/* ftoa Ploating point output conversion routine */ 
® 2 
js */ 
/* This routine depends on the fact that the argument list is always */ 
/* composed of LONG data items. «/ 
/* */ 
/* Configured for Whitesmith’s C on VAX. "“putc” arguments are */ 
/* reversed from UNIX. */ 
7* iA 
[EARERAEERERERRERERRAEERERRERERERRRERERERREREREEHRERRRERERRERERUERREREERERERE / 
/* 

* Include files: 

+/ 
f#finclude <stdio.h> /* just the standard stuff */ 
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/* 
a 
* 


#define HIBIT 31 


Local DEFINES 


/* 

* Local static data: 

*/ 
MLOCAL BYTE * ptrbf = 0; 
MLOCAL BYTE * ptrst = 0; 
MLOCAL BYTE * fmt = 0; 
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/* High bit number of LONG */ 


[PPRREREAREREERERREERERER REED / 
/* Buffer Pointer «/ 
/* -> Pile/string (if any) */ 

x 


/* Pormat Pointer 
[PACAARARRERRRERERARR RESO EES / 
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[AHRERREERERRRRREEHERERRERERERRERERERERERERREEREREREREERERERERHEHREREHREEKERERE 


* 
* PRINTP INTERNAL ROUTINE 
i a 0 A SS SD SOD ND DP a an” a SD DD On 
® 
* Routine “_printf£" is used to handle all "printf" functions, including 
— * “sprintf", and “fprintf". 
* 
a * Calling Sequence: 
* 
* _printf (fd,func,fmt,argl); 
® 
* Where: ; 
* 2 
* fd Is the file or string pointer. 
id func Is the function to handle output. 
* fmt Is the address of the format string. 
7 argl Is the address of the first arg. 
. 
* 
* Returns: 
® 
i Number of characters output 
2 
= Bugs: 
2 
* It is assumed that args are contiguous starting at “argl", and that 
* all are the same size (LONG), except for floating point. ; 
ci 
2 
RERAAEARERAEREARRREREEREERERRERERERERREREREREREREEREREREREREREREREERREREERERER / 
printf (£d,f£,fmt,al) [/*edeeeeeeeetatekeeeeeeeeneen/ 
= LONG fd; /* Not really, but ... */ 
f LONG (*£) ()3 /* Function pointer */ 
Need BYTE *fmt; /* =-> Pormat string «/ 
_ LONG al; /* -> Arg list e/ 
{ : [RRRARRARREERRRRRRARRERRREEERE / 
LOCAL BYTE C3 /* Format character temp «/ 
LOCAL BYTE *s; /* Output string pointer */ 
LOCAL BYTE adj; /* Right/left adjust flag */ 
LOCAL BYTE buf [30]; /* Temporary buffer * 
[RRERARERRERRRERERERREREREEEY / 
LOCAL LONG *adx; /* Arg Address temporary */ 
LOCAL LONG x; /* Arg Value temporary */ 
LOCAL LONG n3 /* String Length Temp a/ 
LOCAL LONG m; /* Field Length Temporary */ 
LOCAL LONG width; /* Field width af 
LOCAL LONG - prec; ° /* Precision for "%x.yf" a/ 
LOCAL LONG padchar; /* ‘O' or ' ' (padding) § */ 
LOCAL DOUBLE ZZ? /* Ploating temporary «/ 
LOCAL DOUBLE *dblptr; /* Floating temp. address */ 
LOCAL LONG ccount; /* Character count */ 
EXTERN _putstr (); /* Reference function */ 
[PRARARARARRERERRRERRREREREE / 
cs 
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ccount = 0; 
_ptrbf = buf; 
aax = al; 
_ptrst = fd; 


C Sample C Module 


SAARAAERARAKNEAREREREENR ERED / 
/* Initially no characters */ 
/* Set buffer pointer */ 
/* Copy address variable */ 
/* Copy file descriptor «/ 


__ fmt = fmt; /* Copy format address «/ 
[PARRARERRRERARRERRERERAR EEE / 
if£(*_ fmt me 'L' || * fmt == '1") /* Skip long output a/ 
__ fmtt+; /* conversions */ 
* ® 
Juauharscecnvavuvavesudessuseuisaesenereveunsiees: iy 
/7* This is the main format conversion loop. Load a character from the «/ 
/* format string. If the character is '%', perform the appropriate «/ 
/* conversion. Otherwise, just output the character. «/ 
[ERARARAREREEERHERERERERREERERERRRRERREREREREEEREEEE */ 
‘* cd 


while(c = *_ fmt++ ) 
if(c t= '$") 


(*f£) (£d,c); 
ccount++; 


else 
x = *adx++; 
if( *_ fmt == '-' ) 


adj = '1l'; 
__rmtt+; 


else 
adj = 'r'; 


padchar=(*_ fmte=s'0') 2? '0' : ' '; 
width = __conv(); 
if( *_ fmt == '.') 


++__ fmt; 
prec = conv(); 


else 
prec = 0; 


-s = 0; 
switch (c= *_ fmt++ ) 


case "D's: 
case ‘d': 
prtl(x); 
Break; 
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/* Pick up next format char*/ 
* * 


SAHRERRERRERRREEREERERERRRES / 


2 * 
/* If not 'S', just output */ 
/* Bump character count «/ 
[ERRRRERREERERRERREEEEREREAERE / 
/* It isa '%', «/ 
/* convert */ 


/* x = address of next arg */ 
[ERRARRRRAERERRERERRERERNEER / 


/* Check for left adjust */ 
LSEREAERERRERREEERRERERREREE / 


/* 18 left, set flag */ 
/* Bump format pointer */ 
/* */ 
/* Right adjust */ 
[ERRERRRERREREREREERERREREEE / 
/* */ 


/* Select Pad character */ 
[ERERRREERREERREREERRDRERREE / 


/* Convert width (if any) */ 
LSRARARAHRERERRERRRRREERERERERE / 
/7* *." means precision spec*/ 
/* * 
/7* Bump past ae */ 
/* Convert precision spec */ 
* 


/* / 
/* None specified * 

LRRRARERERERERERRERREEHERERE / 
/* */ 


/7* Assume no output string */ 
/* Next char is conversion */ 
® * 


vi / 
/* Decimal : e/ 
/* * 


/* Call decimal print rtn */ 
* Go do output * 


[PEAARHRRERERERERHRRERERREEE / 
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st 
Aa 


case ‘o': 

case 'Q'; 
_pPrnts (x); 
break; 


case 'x': 

case ‘'X';: 
_prntx (x); 
break; 


case ‘S‘: 
case 's': 
S=x; 
‘break; 


case ‘C!; 

case ‘c': 
*_ ptrbf++ = x&0377; 
break; 


case ‘E': 

case ‘e': 

case 'F'; 

case 'f'; 
ablptr = adx-1; 
zz = *dblptr; 
adx =+ 1; 


ftoa (zz, buf, prec, c); 


prec = 0; 
s = buf; 
break; 


default: 
(*£) (fd,c); 
ccount++; 
adx--; 


i 
if (s == 0) 


*_ptrbf = '0'; 
s = buf; 


n= strlen (s); 


m= width-n; 


1£ (adj ss 'r') 
while (m-- > 0) 


(*£) (£d,padchar); 
ccount++; 
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C Sample C Module 


/* Octal */ 
/* Print «/ 
/* Call octal printer */ 
/* Go do output ef 
[RRRRRERERRERRERERERERERRERE / 
/* Hex if 
/*® Print 


/* Call conversion routine */ 


/* Go do output 
Jestiazaessscensuntcennbaees) 


7* String */ 

* Output? */ 
/* Yes, (easy) */ 
/* Go finish up */ 
[RARARRERARRRERREREREEEERERE / 
/* Character */ 
/* Output? */ 
/* Just load buffer */ 
/* Go output */ 
[J RRERARRRRERRREREREEREREERER / 
/* Floating point? / 
/* if f 
es */ 
/* */ 
7* Assumes 64 bit float! */ 
/7* Load value e/ 


/7* Bump past second word #/ 
/7* Call floating conversion*/ 
/* Fake out padding routine*/ 
7* just like string print */ 
/* Go Output * 

[RARARRRERERERARERRREERRREREE / 


7* None of the above? &/ 
/* Just Output e/ 
/7* Count it. */ 
/* Fix arg address 2/ 
/7* End switch e/ 


[RRRRAERRERREREERRERRERRERERRE / 
/* T£ s = 0, string is in */ 
/* “but", e/ 
/* Insure termination e/ 
* 


/* Load address 
[RRERRRREREREREREEREERERRERE / 


* & 
/* Compute converted length*/ 
*/ 


n;/* Take min(prec,n) 


/7* mis ¢ of pad characters*/ 
[RERRRERERRERERERRERERRREER SE / 


7* For right adjust, a/ 
/* Pad in front «/ 
/* */ 
/7* Thusly */ 
/*® Count it e/ 

* 2/ 


[AREREAREREERAEREERERERRERRORE / 
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while (n--) 
(*£) (£d,*s8++); 
ccount++; 
while (m=-- > 0) 


(*f£) (fd,padchar); 
ccount++; 


_ptrbf = buf; 
if((*f) == putstr) 
(*£) (£da,'0'); 


return (ccount); 


C Sample C Module 


/* Output Converted «/ 

® a/ 
/* Data */ 
/* Count it */ 

* */ 
[ARAHRARARERERREEERRERRRRERE / 
/* If left adjust, */ 
/* */ 
/* Pad «/ 


/* Count padded characters */ 
LRARRAHERRERERHEREREREEEEERE / 


/* Reset buffer pointer w/ 
* 


/* End else / 
/* End while */ 
/* If string output, */ 


/* Drop in terminator char */ 

[ERERRAERREREREREERERUEERERER / 

/7* Return appropriate value*/ 
* 


/* End printf 
[PERRARERERERERERERRERERERER / 
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C Sample C Module 


[RERHERREERERRREERRERAREREREREREREREREEREREREEREEERRERHREKREREEEEEREREREREERE / 


_PRNT8 


Routine °_prnt8* converts a binary LONG value to octal ascii. */ 


The area at “_ptrbf" is used. 
Calling Sequence: 


_Prnts(n); 


*"n* is the number to be converted. 


Returns: 


(none) 


PROCEDURE */ 


[RRRRRAERERRARERRRRERERERRERERRERRERERERRERERRERRERERREERERERERERERENEEERERR EE / 


VOID _prnts (n) 
LONG 


{ 


All Information Presented Yere 


nz 


REG WORD P? 
REG WORD kz 
REG WORD Sw; 


a (n==0) 
* ptrbf++ = '0'; 
return; 


} 


sw = 0; 
for (p=HIBIT; p >= 0; p 2- 3) 


if ((k = (n>>p)607) || sw) 
if (p==HIBIT) 

k = k & 02; 
*_ptrbf++ = "0 + k; 
sw=il; 


is 
7* Number to convert */ 
f* */ 
/* Counts bits */ 
/* Temporary 3-bit value a/ 
/* Switch 1 => output a/ 
[RARRERARERERERERERERRRKRERRED / 
/* Handle 0 as special case */ 
* x 


/7* Put in one zero */ 
/* And quit _ */ 
*/ 


[RERRERRERERERERREREREREERERE / 


/* Indicate no output yet */. 
/* */ 
/* Use 3 bits at a time */ 
f® */ 
/* Need to output yet? */ 
/* * 

/* lst digit has only 2 bits*/ 
/* Mask appropriately */ 
/* ASCIIfy digit *7 
/* Set output flag a/ 
/* End if a / 
/* End prnts «/ 


[RERERHEREHERRERRERRERRRRERER / 


preva 
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[RARE AEEAREEREREREEEREREEROREREREEEAREREEREREORERRERREREREREREREREREAEER ERED / 


/* */ 
7* _Prntx Punction */ 
/* Sewer ws enraweneemweeew «/ 
/ a, 
/* The “_prntx" function converts a binary LONG quantity to hex ASCII */ 
/* and stores the result in "*_ptrbf". Leading zeros are suppressed. */ 
/* */ 
/* Calling sequence: */ 
7* */ 
A _Prntx(n); *7 
f* *7 
/* where "n" is the value to be converted. */ 
/* */ 
/* Returns: / 
/* */ 
{* (none) */ 
* * 
[PERRERAARERERERAAREEEAEREERRRERREREERREREEREREREREEREREEREREEEEREEREER REESE / 
VOID _prntx (n) /* */ 
LONG n; /* 32 bits */ 

{ [PHRRAAREEAERRRRERRAEERE HERE / 
REG LONG d; /* A digit */ 

REG LONG a; /* Temporary valve . 
[/PRRERRRHRERERHERENREREERRE DS / 

if (a = n>>4) /* Peel off low 4 bits */ 

prntx (a & Oxffffftf); /* Tf <> 0, print first «/ 

d = n&0l?; /7* Take low four bits «/ 

* ptrbf++ = dG > 9 ? ‘A'+d-10 : 'O' + d;/* ASCIIfy into buffer */ 

} = [PREHRAARERESOREERREAURENREES / 
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[ RAAARRRERERRRERERRERRRHEREREEERERREERREREREREEREEEREEEREEREEERRE ERR ERERREERER / 


/* */ 
/* Conv Punecetion a / 
/* wa we cee enews were enw wees */ 
/* */ 
/* Function "_ conv” is used to convert a decimal ASCII string in 2/ 
/* the format to binary. ; */ 
/* */ 
vs Calling Sequence: ny 
/* val = __ conv(); a/ 
/* #/ 
/* Returns: */ 
/* */ 
/* "val" is the converted value */ 
/* zero is returned if no value * 
/* * 
SAARERRRRERERRERERERERRERREARRRERRERRRERERRERRERERRRERRERRERERRRREERREERERERE / 
LONG __conv() r* =} 
= SPRRRERERKERERRRERERERRARRHEE / 
REG BYTE C3 /* Character temporary a/ 
REG LONG n; /* Accumulator * 
[RARREREEREREERERERERRRERERRE / 
n= 0; /* Zero found so far */ 
while(((c= *_ fmtt++) >= '0') /* While c is a digit */ 
&& (c <= '9')) * */ 
n = n*104+c-'0'; /* Add c to accumulator */ 


__fat~—3 


return (n); 


Ss 


83 


/* Back up format pointer to*/ 
/7* character skipped above */ 


/* See, wasn't that simple? */ 
[RARARRRRRERREREERREREREREREE / 
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[ERRERRERRERERRERERERREREREERRERRERRHKEEERHERWEREKERERREREREERRARERERREERRE DHE / 


* */ 
/* _~Putstr Function */ 
/* ST 2 a eee ee eee ean ew ae nen eee ee an oe */ 
* */ 
/* Function "_putstr"® is used by “sprintf” as the output function «/ 
/* argument to "_ printf". A single character is copied to the buffer *%/ 
/* at " ptrst®. “/ t 
/* a */ — 
/* Calling Sequence: «/ 
/* */ 
/* _putstr (str,chr); */ 
f* * 
/* where “str" is a dummy argument necessary because the other output */ 
/* functions have two arguments. * 
/* */ 
/* Returns: «/ 
/* */ 
/* (none) 2/ 
& . 2 
Ve césesasnsceWiscinecovcbacsbesachiaversederiucaiauiianenestouavsrsexenaenies/ 
VOID _putstr (str,chr) /* «/ 
REG BYTE chr; /* The output character */ 
BYTE *str; /7* Dummy argument - */ 
{ [SERARAAKRRERRRERREERRRRERRERE / 
* ptret++ = chr; /* Output the character */ 
return (0); /* Go back i 
} : [RARRERRAEREREERERREREEREREEE / 
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LEER ERREEREAEREEEREEEREEERERRRERERERERRERRERREREREREREEERERERENAEKEERERERR EERO / 


/* af 
/* Pretl Punction */ 
/* ee eo oe ee me ww wwe eee oe «/ 
/* */ 
/* Function “ prtl" converts a LONG binary quantity to decimal ASCII / 
pare /* at the buffer pointed to by “_ptrbf”. */ 
; : 7 ay 
ae /* Calling Sequence: */ 
/* */ 
/* _prtlin); / 
/* */ 
/* where "n" is the value to be converted. */ 
/* a/ 
/* Returns: */ 
ie */ 
7* (none) ‘ *7, 
2 * 
[RRRRARRERRERRERRRERRRREREREREERRRRREERERKRERERREREREERERREERREREREREREREEEEE / 
VOID -_prtl(n) /* */ 
REG LONG ny /* Conversion input * 
{ [RRRHRRERERRRERREREREEREERRER / 
REG LONG digs{15]; /* store digits here 2/ 
REG LONG *dpt; 7* Points to last digit */ 
[RRCRRRRRRERRERERREREREEERE ED / 
dpt = digs; /* Initialize digit pointer */ 
[RARRRRERERERREREERRERERRREEE / 
if (n ># 0) /* Pix */ 
n= <n; {* up */ 
else /* sign */ 
* ptrbf++ = '~'; /* stuff / 
= [RPRERRRERERRERREEREREERERREE / 
for (; n != 0; n = n/10) /* Divide by 10 till zero */ 
yey *dptt++ = n10; 7* Store digit (reverse ord)*/ 
as [RERRARARERERREREREREEREERERE / 
if (dpt == digs) /* Zero value? a/ 
*dpt++ = 0; /* Yes, store 1 zero digit */ 
[RARARRERRERERERERREREREERERRE / 
while (dpt != digs) /* Now convert to ASCII */ 
: /* * 
--dpt; /* Decrement pointer * 
* ptrbf++ = ‘'O' - *dpt; /* Note digits are negativel*/ 
_ * w/ 
} [RARRRARRERRERERHKREKEEERHKERE / 


End of Appendix C 
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Appendix D 
Error Messages 


This appendix lists the error messages returned by the 
components of the CP/M-68K C compiler, the C Parser, C068, the C Co- 
generator, Cl68, the C Preprocessor, CP68, and by the CP/M~68K C 
Run-time Library. The sections are arranged alphabetically. Error 
messages are listed within each section in alphabetical order with 
explanations and suggested user responses. 


D.1 C068 Error Messages 


The CP/M-68K C Parser, C068, returns two types of error 
messages: diagnostic error messages and messages indicating errors 
in the internal logic of C068. Both types of error messages take 
the general forms 


*line no. error message text 


The asterisk (*) indicates that the error message comes from C068. 
The “error message text" describes the error. You must correct any 
errors you receive from C068 before invoking Cl68. Uncorrected 
errors from C068 cause erroneous error messages to occur when you 
run C168. 


D.1.1 Diagnostic Error Messages 
These error messages occur mostly in response to syntax errors 
in the source code. Refer to your C language manual for a complete 


discussion of the C language syntax. 


The error messages are listed in Table D-l1 in alphabetical 
order with short explanations and suggested user responses. 
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Table D-1. C068 Diagnostic Error Messages 


Message Meaning 


*line no. address of register 


You have attempted to take the address of 
a register. Correct the source code 
before you recompile it. 


assignable operand required 


bad 


bad 


can' 


On the line indicated, the operand to the 
left of the equals sign in the assignment 
statement is not a valid operand. Supply 
a valid operand. This error might occur 
because the operand is a constant instead 
of a variable. 


character constant 


A character constant on the line indicated 
is invalid. The character constant must 
be a single character between quotes. A 
control character, more than one 
character, or a symbol that is not a 
character will cause this error to occur. 


indirection 


You attempted to reference by address 
instead of by value, but the expression 
you used is not an address. Supply a 
value or a valid address before you 
recompile the source code. 


t open filename 


Either the filename or the drive code is 
incorrect. Specify the correct drive code 
and filename before you recompile the 
source code. 


case not inside a switch block 


The case on the line indicated is not 
inside a switch block. Correct the source 
code before you recompile it. 
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Table D-1. (continued) 


SESS ee ae, ee Re SSC Se Ae We SO 


sages 


Message Meaning 


*line no. character constant too long 


The character constant on the line 

er indicated is too long. A character 
constant must be a single character 
between quotes. Correct the source code 
before you recompile it. 


constant required 


The operation on the line indicated 
requires a constant. Correct the error 
before you recompile the source code. 


declaration syntax 


The syntax of the declaration on the line 
indicated is incorrect. Refer to your C 
language manual. Correct the syntax 
before you recompile the source code. 


default not inside a switch block 


C) 


The default on the line indicated is not 
inside a switch block. Correct the source 
code before you recompile it. 


dimension table overflow 


There are too many dimensions, at or prior 
to the line indicated, for the dimension 
table. The dimension table does not have 
space for more than 8 or 9 dimensions. 
Structures count as dimensions. Rewrite 
the source code to use fewer dimensions 
and structures before you recompile it. 


*line no. duplicate case value 


Two cases for the same switch are 
. identical. Eliminate one of the cases 
Nes before you recompile the source code. 
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Table D-l. (continued) 


Message Meaning 


*line no. expected label 


A go to statement on the line indicated 
does not have a label. Supply the missing 
label before you recompile the source 
code. 


a, 


expression too complex 


Due to internal limitations in C068, the 
expression on the line indicated is too 
complex to be evaluated. Simplify the 
expression before recompiling the source 
code. 


external definition syntax 


The syntax of the external definition on 
the line indicated is incorrect. Correct 
the syntax before you recompile the source 
code. Refer to your C language manual for 
the correct syntax. 


field overflows byte 


The bit field asks for more bits than fit 
in an 8—bit byte. Reduce the number of 
bits in the bit field before you recompile 
the source code. 


field overflows word 


The word field asks for more bytes than. 
fit in a word. Reduce the number of bytes 
in the byte’ field before you recompile the 
source code. 


floating point not supported 


CP/M-68K does not support floating point. 
Rewrite the source code before you 
recompile it. 
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Table D-l1. (continued) 


Message Meaning 


*line no. function body syntax 


There is no bracket at the beginning of 
as ‘the function on the line indicated. 
Supply the missing bracket before you 
recompile the source code. 


*line no. illegal call 


You attempted to call something that is 
not a function. Correct the source code 
before you recompile it. 


*line no. illegal function declaration 


The storage class of the function declared 
in the line indicated is illegal. The 
only two storage classes allowed for 
functions are static and external. 
Correct the declaration before you 
recompile the source code. 


a, *line no. illegal register specification 


The register specification in the line 
indicated is illegal. Structures and 
arrays cannot be put into a register. 
Correct the source code before you 
recompile it. 


*line no. illegal type conversion 


You made an incompatible assignment. This 
error commonly occurs when attempting to 

- convert a pointer, 32 bits, to an int, 16 
bits. Correct the source code before you 
recompile it. 


*line no. indirection on function invalid 


You attempted to use the indirection 
oy operator (*) on a function. Correct the 
source code before you recompile it. 
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Yable D-l. (continued) 


Message Meaning 


*line no. initializer alignment 


This message usually indicates a missing 
initializer value, or values out of order. 
Check the initializer list and correct it 
before you recompile the source code. 


*line no. initializer list too long 


The initializer list is too long for C068. 
Shorten the list before you recompile the 
source code. 


*line no. invalid break statement 


The break statement on the line indicated 
is not inside a loop or a switch. Correct 
the source code before you recompile it. 


*line no. invalid character 


There is an invalid character in the 

collating sequence in the line indicated. 
Control characters or members of the 
extended character set are not valid 
characters. Correct the source code 
before you recompile it. 


*Line no. invalid continue statement 


The continue statement on the line 
indicated is not inside a loop. This. 
error might occur when you have used a 
continue statement in a switch. A 
continue statement is only valid in a 
Loop. Correct the source code before 
reinvoking C068. 


*line no. invalid conversion 


You attempted an incompatible assignment, 
for example, a pointer, 32 bits, and an 
int, 16 bits. Correct the source code 
before you recompile it. 
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Message Meaning 


*line no. 


— 


*line no. 


*line no. 


*line no. 


*line no. 


*line no. 


Table D-1l. (continued) 


invalid data type 


The line indicated contains an expression 
that attempts to equate two incompatible 
quantities, for example, an int, 16 bits, 
and a pointer, 32 bits. Correct the 
source code before you recompile it. 


invalid declarator 


The declarator in the line indicated is 
not a recognizable language element. 
Supply a valid declarator before you 
recompile the source code. 


invalid expression 


The expression in the line indicated 
contains a syntax error. Correct the 
syntax of the expression before you 
recompile the source code. 


invalid field size 


The field in the line indicated is less 
than or equal to zero. Correct the field 
size before you recompile the source code. 


invalid field type description 


You attempted to put a pointer or a long 
into a bit field. Correct the source code 
before you recompile it. 


invalid for statement 


The for statement in the line indicated 
contains a syntax error. Refer to your C 
language manual for the correct syntax of 
a for statement. Correct the statement 
before you recompile the source code. 


D.1 C068 Error Messages 


PELE ESET S GRY STE ETS eS TEE BOE ns RE oe SR RN ne 


a a ot iri al asi acer eS at ae A a ie i et ee ae 


i ch 5" ET eae ‘Ti Li ols RR ee me Me ee ta ee eR” Fie pees ge Oe Re! ON sll 


C Programming Guide D.1 C068 Error Messages 


Table D-l. (continued) 


Message Meaning 


*line no. invalid initializer 


The initializer you specified in the line 
indicated is not a constant. You can only 
initialize to a constant. Correct the 
source code before you recompile it. 


invalid label 


You used a variable name as a label in the 
line indicated. Correct the source code 
before you recompile it. 


invalid long declaration 


You attempted to declare something long 
that cannot be long, for example, a 
character. Correct the source code before 
you recompile it. 


invalid operand type 


The expression in the line indicated 
contains an invalid operand. Correct the 
source code before you recompile it. 


invalid register specification 


You attempted to put something larger than 
allowed into a register, for example, a 
structure or a function. Correct the 
source code before you recompile it. 


invalid short declaration 


You attempted to declare something short 
that cannot be short. Correct the source 
code before you recompile it. 
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Message Meaning 


*line no. 


*line no. 


*line no. 


*line no. 


*line no. 


*line no. 


All Information 


Presented Here is 


Table D-l. (continued) 


invalid storage class 


You specified an invalid storage class in 
a declaration. Refer to your C language 
Manual for the allowed storage classes. 
Correct the source code before you 
recompile it. 


invalid structure declaration: name 


The size of the structure indicated by the 
variable "name" has a size less than or 
equal to zero. Correct the source code 
before you recompile it. 


invalid structure member name 


The structure reference in the line 
indicated is not a member of any 
structure. Correct the source code before 
you recompile it. 


invalid structure prototype: name 


In the line indicated you reference a 
structure name that is not a prototype. 
Correct the source code before you 
recompile it. 


invalid type declaration 


The type declared in the line indicated is 
invalid. Refer to your C language manual ° 
for a discussion of valid types. Correct 
the source code before you recompile it. 


invalid typedef statement 


The line indicated contains a statement 
with more than one typedef keyword. Only 
one typedef is allowed per statement. 
Correct the source code before you 
recompile it. 


ae 
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fable D-l. (continued) 


Message Meaning 


*line no. invalid unsigned declaration 


The quantity you declared unsigned in the 
line indicated might not be unsigned. 
Only an int can be unsigned. Correct the 
declaration before you recompile the 
source code. 


invalid ?: operator syntax 


This message indicates an error in the use 
of the ?: conditional operator in the line 
indicated. Refer to your C language 
manual for the correct syntax. Correct 
the source code before you recompile it. 


label redeclaration: label 
You used the same label for two separate 


items. Correct the source code before you 
recompile it. 


missing colon 


~ You left out a colon. ‘Supply a colon in 
the correct location before you recompile 
the source code. 


missing ‘{ in initialization 


You neglected to put in the left curly 
brace in the initialization of an array or 
structure. Supply the missing brace 
before you recompile the source code. 


missing } 


You left the right curly brace out of the 
initialization of an array or structure. 
Supply the missing brace before you 
recompile the source code. 
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Table D-l. (continued) 


*line no. missing while 


The do statement at the line indicated is 
missing a while at the end. Supply the 
missing while before you recompile the 
source code. x 


missing semicolon 


A semicolon is missing from the line 
indicated. Supply the missing semicolon 
before you recompile the source code. 


no structure name 


You referred to a structure in the line 
indicated without giving the structure 
name. Correct the source code before you 
recompile it. 


no */ before EOF 


The last comment in the source code is 
missing its final delimiter. Supply the 
‘missing delimiter before you recompile the 
source code. 


a structure: name 


The structure referenced in the line 
indicated is not a structure. Correct the 
source code before you recompile it. 


in parameter list: x 


In the line indicated, you declared the 
something indicated by the variable "x" to 
be an argument to a function, but "x" is 
not in the function parameter list. 
Correct the source code before you 
recompile it. 
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Table D-l. (continued) 


*line no. parenthesized expression syntax 


The line indicated contains a syntax error 
in the parenthesized expression. Correct 
the source code before you recompile it. 


*line no. redeclaration: symbol 


A symbol has been declared twice. Remove 
on of the declarations before recompiling 
the source code. 


*line no. string cannot cross line 


The character string at the line indicated 
continues beyond one line. The closing 
quote to a character string must be on the 
same line as the opening quote, unless you 
use a backslash (\) at the end of the 
first line to indicate that the line 
continues. Correct the source code before 
you recompile it. 


*line no. string too long 


The string at the line indicated is longer 
than 255 characters. A string cannot be 
longer than 255 characters on a single 
line. Break the string and use a 
continuation, indicated by a backslash (\) 
at the end of the line to be continued. 


*line no. structure declaration syntax 


The syntax of the structure declaration on 
the line indicated is incorrect. Correct 
the syntax before reinvoking C068. 


*line no. structure operation not yet implemented 


pe Ro perenne A NR NN 


On the line indicated, you assigned a 
structure to another structure. Assigning 
a structure to another structure is not 
yet supported by the CP/M-68K C compiler. 
Correct the source code before reinvoking 
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*line no. 


*line no. 


*line no. 


*line no. 


*line no. 


*line no. 


Table D-1. (continued) 


structure table overflow 


There are too many Structures in your 
program for the structure tables. 
Eliminate some structures before 
reinvoking the C compiler. 


Symbol table overflow 


Your program uses too many symbols for the 
space available on the symbol table. 
Eliminate some symbols before reinvoking 
the C compiler. 


temp creation error 


The drive code or filename of the 
temporary file referenced in the line 
indicated is incorrect. Specify the 
correct drive code and filename before you 
recompile the source code. 


many cases in switch 


‘The switch at the line indicated has too 
many cases. Eliminate some cases before 
you recompile the source code. 


many initializers 


The initializer list in the line indicated 
contains more initializers than there are 
members of the array being initialized. 
Correct the list before you recompile the 
source code. 


Many params 


The function declaration at the line 
indicated contains too many parameters. 
Rewrite the source code before you 
recompile the source code. 
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errno 
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Table D-l. (continued) 


Message Meaning 


*line no. undefined label: label 


The label indicated by the variable 
"label" has not been defined. Correct the 
source code before you recompile it. 


undefined symbol: symbol 


The symbol indicated by the variable 
"symbol" is undefined. Correct the source 
code before you recompile it. 


unexpected EOF 


This error usually occurs when there is no 
right curly brace (}) after a function, or 
when there are mismatched comment 
delimiters. Locate and correct the error 
before you recompile the source code. 


usage: c068 source asm str 


The syntax of the C compiler command line 
is incorrect. The correct syntax is given 
in the error message. Reenter the command 
line using a valid syntax. 


{ not matched by } 


A left curly brace ({) is not matched by a 
right curly brace. This error frequently 
occurs in an initialization sequence. 
Supply the missing brace before you 
recompile the source code. 


="char" assumed 


You have user a =+ type operation with an 
invalid character. When an invalid 
character occurs after the = sign, C068 
puts in == instead of =. Correct the 
source code before you recompile the 
source code. 
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Table Del. (continued) 


Message Meaning 


*line no. & operand illegal 


“You attempted to take the address of 
something that is not a variable, for 

example, a register. Correct the source 

code and recompile it. 


D.1.2 Internal Logic Errors 


These messages indicate fatal errors in the internal logic of 
C068: 


*line no. can't copy filename 

*line no. invalid keyword 

*line no. too many chars pushed back 
*line no. too many tokens pushed back 


Contact the place you purchased your system for assistance. 
Provide the following information: 

© Indicate the version of the operating system you are using. 

© Describe your system's hardware configuration. 
o Provide sufficient information to reproduce the error. 
Indicate which program was running at the time the error 
occurred. If possible, also provide a disk with a copy of the 
program. 
D.2 C168 Error Messages 

The CP/M-68K C Co-generator, C168, returns two types of fatal 
error messages: diagnostic error messages and messages indicating 
errorg in the internal logic of C168. Both types of error messages 
take the general form: 

**line no. error message text 

The asterisks (**) indicate that the error message comes from C168. 
The error message text describes the error. If you run C168 before 


correcting any errors you received from C068, you receive erroneous 
errors from C168. 
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D.2 C168 Error Messages 


The C168 fatal, diagnostic error messages are listed in Table 
D-2 in alphabetical order, with explanations and suggested user 


responses. 


Table D-2. C168 Fatal Diagnostic Errors 


Message Meaning 


**line no. can't create filename 


Either the drive code or the filename for 
the file indicated by the variable 
“filename” is incorrect. Ensure that you 


are requesting 
filename befor 
code, 


the correct drive code and 
e you recompile the source 


**line no. can't open filename 


Either the drive code or the filename for 
the file indicated by the variable 
"filename" is incorrect. Ensure that you 


are requesting 
filename befor 
code. 


**line no. divide by zero 


You attempted 


the correct drive code and 
e you recompile the source 


to divide by zero in the 


line indicated. Correct the source code 


before you rec 


ompile it. 


**#line no. expression too complex 


An expression on the line indicated is too 
complex for C168. Simplify the expression 
before you recompile the source code. 


**line no. modulus by zero 


The second operand of the percent operator 
in the line indicated is zero. Correct 
the source code before you recompile it. 
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Table D-2. (continued) 


Message Meaning 


**line no. structure operation not implemented 


The operation you attempted with a 
structure in the line indicated is 
illegal. Correct the source code before 
you recompile it. 


**line no. usage: cl168 icode asm [-DLmec] 


The command line syntax is incorrect. The 
correct command line syntax is given in 
the error message. Correct the syntax 
before you reenter the command line. 


D.2.2 Internal Logic Errors 


The following messages indicate fatal errors in the internal 
logic of C168: 


**line no. cdsize: invalid type 
**line no. code skeleton error: op 
**line no. hard long to register 
**line no. intermediate code error 
**line no. invalid initialization 
**line no. invalid operator op 

**line no. invalid register expression 
**line no. invalid storage class sc 
**line no. no code table for op 

**line no. skelmatch type: stype 


If you receive one of these messages, contact the place where you 


purchased your system for assistance. Provide the following 
information: 


@ Indicate the version of the operating system you are using. 

@ Describe your system's hardware configuration. 

e Provide sufficient information to reproduce the error. 
Indicate which program was running at the time the error 


occurred. If possible, also provide a disk with a copy of the 
program. 
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D.3 CP68 Error Messages 


The CP/M-68K C Preprocessor, CP68, returns two types of fatal 
error messages: diagnostic error messages and messages indicating 
errors in the internal logic of CP68. Both types of error messages 
take the general form: 


# line no. error message text 


The pound sign (#) indicates that the error message comes from CP68. 
The “error message text" describes the error. 


D.3.1 Diagnostic Error Messages 


A fatal diagnostic error message prevents CP68 from processing 
your file. The CP68 diagnostic error messages are listed in Table 
D-3 with explanations and suggested user responses. 


Table D-3. CP68 Diagnostic Error Messages 


Message Meaning 


# line no. argument buffer overflow 


An argument list in the line indicated 
contains too many characters for the space 
allocated to the argument buffer. Reduce 
the number of characters in the argument 
list before rerunning CP68. 


# line no. bad argument: arg 


In the line indicated, the argument 
represented by the variable "arg" contains 
an invalid character. Replace or 
eliminate the invalid character before 
rerunning CP68. 


# line no. bad character octal no. 


The line indicated contains an illegal 
character. The ASCII code of the invalid 
character is represented by the variable 
"octal no." Examine the line indicated to 
locate the error. Replace the character 
before rerunning CP68. 
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Table D-3. (continued) 


Message Meaning 


bad define name: name 
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The name indicated by the variable “name” 
contains one or more invalid characters. 
Examine the name to locate the error. 
Replace the invalid characters before 
rerunning CP68. 


bad include file 


The syntax of the “#include" statement is 
incorrect. The "#include" statement must 
follow one of the following two formats: 


#include <filename> 
#include "filename" 


Rewrite the statement before rerunning 
CP68. 


- # line no. bad include file name 


In the line indicated, the filename in the 
"tinclude” statement contains either an 
invalid character or more than 8 
characters, the maximum allowed. Supply a 
valid filename before rerunning. CP68. 


# line no. can't open fname 


The “#include" statement in the line 
indicated contains an invalid or 
nonexistent filename. Check the filename 
before rerunning CP68. 


can't open infile 


 Anatede: 
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CP68 cannot open the input file indicated 
by the variable “infile"’. Either the 
drive code or the filename is incorrect. 
Check the drive code and the filename 
before rerunning CP68. 
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Table D-3. (continued) 


Message Meaning 


# line no. can't open outfile 


CP68 cannot open the output file indicated 
by the variable “outfile.” Either the 
drive code is incorrect, or the disk to 
which CP68 is writing is full. Check the 
Grive code. If it is correct, the file is 
full. Erase unnecessary files, if any, or 
insert a new disk before rerunning CP68. 


# line no. condition stack overflow 


The source code contains too many nested 
#if's for the space allocated to the 
condition stack. The stack overflowed 
before the line indicated. Rewrite the 
source code before rerunning CP68. 


# line no. define recursion 
A name or variable on the line indicated 


has been defined in terms of itself. 
Redefine the name before rerunning CP68. 


# line no. define table overflow ; 


The source code contains one or a 
combination of the following: too many 
names, too many long names, too many 
expressions, or, too many large 
expressions. The space allocated to the 
define table was filled before the line 
indicated. Simplify and rewrite the 
source code before rerunning CP68. 


# line no. expression operator stack overflow 


An expression in the line indicated 
contains too many operations for the space 
allocated to the expression operator 
stack. Eliminate or consolidate some 
operations before rerunning CP68. 
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Table D-3. (continued) 


# line no. expression stack overflow 


An expression in the line indicated 
contains too many terms for the space 
allocated to the expression stack. 
Eliminate or consolidate some terms before 
rerunning CP68. 


# line no. expression syntax 


The syntax of an expression in the line 
indicated is incorrect. Examine the line 
to locate the error. Correct the syntax 
before rerunning CP68. 


# line no. includes nested too deeply 


The “*#include" statement in the line 

indicated contains more than 7 nested 

include files, the maximum allowed. 

Rewrite the source code so that no one 
; "#include" statement contains more than 7 
‘ nested include files. 


# line no. invalid #else 


A "telse" statement occurs in the source 
code without a preceding "#if" statement. 
Supply the missing "#if" statement or 
eliminate the “#else" statement before 
rerunning CP68. 


# line no. invalid tendif 


A "tendif* statement occurs in the source 
code without a preceding “#if" statement. 
Supply the missing "#if" statement or 
eliminate the “#endif" statement before 
rerunning CP68. 


CZ # line no. invalid preprocessor command 


The command in the line indicated is 
either not valid for CP68 or is 
incorrectly formatted. Correct the 
command before rerunning CP68. 
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Message Meaning 


line overflow 


# line no. 
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Table D-3. (continued) 


The line indicated contains more than 255 
characters, the maximum allowed. Reduce 
the line to no more than 255 characters 
before rerunning CP68. 


macro argument too long 


An argument name in the line indicated 
contains more than 8 characters, the 
Maximum allowed. Use no more than 8 
characters for the argument name, and 
rerun CP68. 


*/ before EOF 
A comment in the source code is missing 


the closing */. Supply the missing */ 
before rerunning CP68. 


string cannot cross line 


A string in the line indicated is missing 


a closing quotation mark. Supply the 
missing quotation mark before rerunning 
CP68. 


string too long 


The line indicated contains a string 
greater than 255 characters, the maximum 
allowed. Shorten the string to no more 
than 255. characters before rerunning CP68. 


symbol table overflow 


The source code uses too many symbols for 
the space allocated to the symbol table. 
The symbol table was filled prior to the 
line indicated. Eliminate some symbols 
before rerunning CP68. 
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Table D-3. (continued) 


# line no. too many arguments 


One of the names in the line indicated 
contains more than 9 arguments, the 
Maximum allowed. Reduce the number of 
arguments to no more than 9 per name 
before rerunning CP68. 


# line no. unexpected EOP 


This message indicates an incomplete 
progran. Examine the source code to 
locate the error. Correct before 
rerunning CP68. 


# line no. unmatched conditional 


A "“#if" statement occurs in the source 
code without a matching “#tendif" 
statement. Supply the missing “#endif" 
statement before rerunning CP68. 


# line no. usage: c68 [<i x:] inputfile outputfile 


This message indicates incorrect syntax in 
the command line. The correct syntax is 
given. Correct the command line before 
rerunning CP68. Refer to your C manual 
for an explanation of the command line 
syntax. 


D.3.2 Internal Logic Errors 


CP68 returns only one message indicating an error in the 
internal logic of CP68: 


_# line no. too many characters pushed back 


If you receive this message, contact the place where you purchased 
your system for assistance. Provide the following information: 


@ Indicate the version of the operating system you are using. 


@ Describe your system's hardware configuration. 
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e Provide sufficient information to reproduce the error. 
Indicate which program was running at the time the error 
occurred. If possible, also provide a disk with a copy of the 
program. 


D.4 C-Run-time Library Error Messages 
The C-Run-time Library returns only one fatal error message, 
stack overflow. The stack overflow message means the program you 


are trying to include in the C~Run-time Library is too big. Reduce 
the size of the program. 


End of Appendix D 
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command line interface, 4 
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compiler, 71-73 
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-F option, 72 
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fclose function, 16, 22 
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fflush function, 22 
fgets function, 32 
field width, 40 
file access, 
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file descriptor, 56 
file I/O, 5 
file pointer, 46 
file size, reducing, 73 
file statements, 66 
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file.0, 72 
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conversion, 40 
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for, 67 
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formatting data, 39 
fprintf function, 39 
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frame pointer, 2 
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freopen function, 24 
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getc function, 28, 57 
getchar function, 28 
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getpid function, 31 
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internal translation, 1 
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L character, 40 

-L option, 72 

language library, compatibility 
with UNIX V7, 7 

leading sign, 12 
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line A trap, 50 

line F trap, 50 

linkage editor, 2, 72 

linker, 71-73 
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listing device, 27 
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LO68, 71, 72 

load modules, 73 

load time, reducing, 73 

LOCAL, 63, 66 
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longjmp function, 49 
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bytes, 55 
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lseek function, 35, 59 
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macro definitions, 62 
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malloc function, 2, 14 
mandatory coding conventions, 62 
Margin, 66 ; 
masking, 64 : 
memory allocation, 21 
memory layouts of C programs, 1 
minus sign, 40 ~ 
mktemp function, 36 
MLOCAL, 63 
modular programs, 61 
module, 
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module-specific #define 
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© operator, 40 
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ASCII, 40, 48 
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open function , 16, 24, 37, 46 
open stream, 23, 47 
epena function, 37 
openb function, 37 
opening files, 37 
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padding, blank or zero, 40 
parentheses, 62, 64 
parser, 71 


aS password, 30 


PDP-11, 55 

percent sign, %, 39 
peripheral devices, 5 
perror function, 38, 69 
pointer arithmetic, 64 
portability, 61-66 
precision field, 40 
precision string, 40 
preprocessor, 71 

primary memory, 26 

printf function, 39, 62, 64 
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privilege violation, 50 
procedure definitions, 66 
procedure header, 66 
process ID, false, 31 
punctuation characters, 18 
pushed-back characters, 57 
putc function, 41 

putchar function, 41 

putl function, 41 
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, putw function, 41 
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qsort function, 44 
quick sort routine, 44 
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-R option, 72 
rand function, 45 
random number generator, 45 
random numbers, retrieving, 45 
read errors, 29 
read function, 28, 46 
read pointer, 27 
readability, improving, 67 
realloc function, 14 
references, global, 66 
REG, 63 

oo registers, scratch, 3 

eS regular files, 5 

. reloc utility, 73 

relocatable files, 72 
rewind function, 27 
rindex function, 33 
ROM, 65 
run-time start-up routine, 72 
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sample C module, 75 

sbrk function, 2, 13, 20 
scanf function, 47 
screen editing, 66 

seed, 45 

setjmp function, 49 


sign-extending characters, 62 


signal function, 50 
Signed characters, 52 
single-byte I/O, 5 


Single-density disk system, 73 


source file, 71 
space, 18 
allocation for array, 14 
sprintf function, 39 
srand function, 45 
sscanf function, 47 
stack frame, 4 
stack use, 2 
stack-popping code, 3 
Standard error file, 5 


standard type definitions, 63 


Start-up file, 72 

static data, 30 

static variables, 65 

Stderr, 5 

stdin, 5 

<stdio.h> file, 5, 10, 28, 

stdout, 5 

storage class, 66 
definitions, 63 

strcat function, 51 

strcmp function, 52 

strcepy function, 53 


stream, 
address, 22 
buffer, 35 


file, 27, 32 

output file, 21 
string, 
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length, 54 

null-terminated, 30 

variables, 64 
strlen function, 54 
strncat function, 51 
strncemp function, 52 
stylistic rules inc 

programs, 61 
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submit files, 73 
Subroutine calls, 3 
Subtraction, 64 
suppressed assignments, 48 
swab function, 55 
Swapping binary data, 55 
Symbolic constants, 61 
symbolic names, 69 
system, 

calls, 8 

error, 38 

include files, 71 

traps, 7 
system-wide file, 61 
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-T switch, 74 

tab, 18, 48, 67 

tell function, 35 
temporary file, 71 
terminal device, 56 
terminating current program, 9 
text, 65 

tilde, 18 

trace trap, 50 
trailing null, 43, 48 
transferring data, 59 
TRAPV instruction, 50 
ttyname function, 56 
type, 61 

type definitions, 63 
typedef 63 
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u operator, 40 
-U option, 72 
UBYTE, 63 
underline character, 3 
wnagetc function, 57 
uninitialized data , l, 65 
UNIX, 
compatibility, 15, 38, 
43, 50 
versions 1 through 6, 35 
version 7, 70 
with fopen, 25 
with getpid, 31 
with getchar, 29 
UNIX programs, with binary 
files, 17, 37 
unlink function, 58 
unsigned characters, 52 
unsigned int, 62{ 


upper bound of program, 

setting, 13 
upper-case, 1, 8, 62, 63 
user control block, 5. 
UWORD, 63 
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variable, 66 
variable names, 
global, 62 
local, 62 
lower-case, 62 
variable type, 66 
VAX, 55 
vectors, sorting, 44 
VOID, 63 
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while, 67 
white space characters, 18 
WORD, 63 
word, 
16-bit, 41 
32-bit word, 41 
word boundary, 14 
write function, 41, 59 
write pointer, 27 
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X characters, 36, 40, 48 
X operator, 40 
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zero divide, 50 
zero padding, 40 


eve ak 


